SHGetItemFromDataObject, fonction (shobjidl_core.h)

Crée un objet IShellItem ou associé basé sur un élément spécifié par un IDataObject.

Syntaxe

HRESULT SHGetItemFromDataObject(
  [in]  IDataObject            *pdtobj,
  [in]  DATAOBJ_GET_ITEM_FLAGS dwFlags,
  [in]  REFIID                 riid,
  [out] void                   **ppv
);

Paramètres

[in] pdtobj

Type : IDataObject*

Pointeur vers l’instance IDataObject source.

[in] dwFlags

Type : DATAOBJ_GET_ITEM_FLAGS

Une ou plusieurs valeurs de l’énumération DATAOBJ_GET_ITEM_FLAGS pour spécifier des options concernant l’objet cible. Cette valeur peut être 0.

[in] riid

Type : REFIID

Référence à l’IID de l’interface à récupérer via ppv, généralement IID_IShellItem.

[out] ppv

Type : void**

Lorsque cette méthode est retournée, contient le pointeur d’interface demandé dans riid. Il s’agit généralement d’IShellItem.

Valeur retournée

Type : HRESULT

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT .

Remarques

Il est recommandé d’utiliser la macro IID_PPV_ARGS , définie dans Objbase.h, pour empaqueter les paramètres riid et ppv . Cette macro fournit l’IID correct basé sur l’interface pointée par la valeur dans ppv, ce qui élimine la possibilité d’une erreur de codage.

Spécifications