Leggere in inglese

Condividi tramite


Funzione SHGetItemFromDataObject (shobjidl_core.h)

Crea un oggetto IShellItem o correlato in base a un elemento specificato da un IDataObject.

Sintassi

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

Parametri

[in] pdtobj

Tipo: IDataObject*

Puntatore all'istanza IDataObject di origine.

[in] dwFlags

Tipo: DATAOBJ_GET_ITEM_FLAGS

Uno o più valori dell'enumerazione DATAOBJ_GET_ITEM_FLAGS per specificare le opzioni relative all'oggetto di destinazione. Questo valore può essere 0.

[in] riid

Tipo: REFIID

Riferimento all'IID dell'interfaccia da recuperare tramite ppv, in genere IID_IShellItem.

[out] ppv

Tipo: void**

Quando questo metodo restituisce, contiene il puntatore dell'interfaccia richiesto in riid. Questo è in genere IShellItem.

Valore restituito

Tipo: HRESULT

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

È consigliabile usare la macro IID_PPV_ARGS definita in Objbase.h per creare il pacchetto dei parametri riid e ppv . Questa macro fornisce l'IID corretto in base all'interfaccia a cui punta il valore in ppv, che elimina la possibilità di un errore di codifica.

Requisiti

Requisito Valore
Client minimo supportato Windows 7 [solo app desktop]
Server minimo supportato Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione shobjidl_core.h (include Shobjidl.h)
DLL Shell32.dll (versione 6.1 o successiva)