Função SHCreateShellItemArray (shobjidl_core.h)

Cria um objeto de matriz de itens shell.

Sintaxe

SHSTDAPI SHCreateShellItemArray(
  [in]  PCIDLIST_ABSOLUTE     pidlParent,
  [in]  IShellFolder          *psf,
  [in]  UINT                  cidl,
  [in]  PCUITEMID_CHILD_ARRAY ppidl,
  [out] IShellItemArray       **ppsiItemArray
);

Parâmetros

[in] pidlParent

Tipo: PCIDLIST_ABSOLUTE

A lista de IDs da pasta pai dos itens especificados em ppidl. Se psf for especificado, esse parâmetro poderá ser NULL. Se esse pidlParent não for especificado, ele será calculado do parâmetro psf usando IPersistFolder2.

[in] psf

Tipo: IShellFolder*

O objeto de fonte de dados shell que é o pai dos itens filho especificados em ppidl. Se pidlParent for especificado, esse parâmetro poderá ser NULL.

[in] cidl

Tipo: UINT

O número de elementos na matriz especificada por ppidl.

[in] ppidl

Tipo: PCUITEMID_CHILD_ARRAY

A lista de IDs de item filho para as quais a matriz está sendo criada. Esse valor pode ser NULL.

[out] ppsiItemArray

Tipo: IShellItemArray**

Quando essa função retorna, contém o endereço de um ponteiro de interface 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.

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