Função SHCreateShellItemArrayFromDataObject (shobjidl_core.h)

Cria um objeto de matriz de itens shell de um objeto de dados.

Sintaxe

SHSTDAPI SHCreateShellItemArrayFromDataObject(
  [in]  IDataObject *pdo,
  [in]  REFIID      riid,
  [out] void        **ppv
);

Parâmetros

[in] pdo

Tipo: IDataObject*

Um ponteiro para a interface IDataObject .

[in] riid

Tipo: REFIID

Uma referência à ID da interface desejada.

[out] ppv

Tipo: void**

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

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

Essa função é útil para extensões shell que implementam IShellExtInit e são passadas um objeto de dados para o método IShellExtInit::Initialize ; por exemplo, manipuladores de menu de contexto.

Essa API permite converter o objeto de dados em um item shell que o manipulador pode consumir. É recomendável que os manipuladores usem uma matriz de itens shell em vez de formatos de área de transferência, como CF_HDROP e CFSTR_SHELLIDLIST (também conhecido como HIDA), pois ele leva a um código mais simples e permite algumas melhorias de desempenho.

A matriz de itens de shell resultante contém uma referência ao objeto de dados de origem. Portanto, esse objeto de dados deve permanecer válido durante o tempo de vida da matriz de itens do shell. Notavelmente, os objetos de dados passados para métodos IDropTarget não são mais válidos após a conclusão da operação de descarte.

Requirements