Função SHGetItemFromDataObject (shobjidl_core.h)

Cria um IShellItem ou objeto relacionado com base em um item especificado por um IDataObject.

Sintaxe

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

Parâmetros

[in] pdtobj

Tipo: IDataObject*

Um ponteiro para a instância IDataObject de origem .

[in] dwFlags

Tipo: DATAOBJ_GET_ITEM_FLAGS

Um ou mais valores da enumeração DATAOBJ_GET_ITEM_FLAGS para especificar opções sobre o objeto de destino. Esse valor pode ser 0.

[in] riid

Tipo: REFIID

Uma referência à IID da interface a ser recuperada por meio de ppv, normalmente IID_IShellItem.

[out] ppv

Tipo: void**

Quando esse método é retornado, contém o ponteiro de interface solicitado no riid. Normalmente, isso é IShellItem.

Valor de retorno

Tipo: HRESULT

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT .

Observações

É recomendável que você use a macro IID_PPV_ARGS , definida em Objbase.h, para empacotar os parâmetros riid e ppv . Essa macro fornece a IID correta com base na interface apontada pelo valor em ppv, o que elimina a possibilidade de um erro de codificação.

Requirements