Função SHCreateShellItemArrayFromShellItem (shobjidl_core.h)

Cria uma matriz de um elemento de um único item shell.

Sintaxe

SHSTDAPI SHCreateShellItemArrayFromShellItem(
  [in]  IShellItem *psi,
  [in]  REFIID     riid,
  [out] void       **ppv
);

Parâmetros

[in] psi

Tipo: IShellItem*

Ponteiro para o objeto IShellItem que representa o item.

[in] riid

Tipo: REFIID

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

[out] ppv

Tipo: void**

Quando esse método retorna, contém o ponteiro de interface solicitado em riid. Normalmente, esse é um ponteiro para um IShellItemArray.

Retornar valor

Tipo: HRESULT

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

Comentários

Essa função cria uma matriz de um elemento com base em um único item. Para criar uma matriz com base no conteúdo de uma pasta, use SHCreateShellItemArray.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shobjidl_core.h (inclua Shobjidl.h)
DLL	Shell32.dll