Compartilhar via

Função SHCreateShellItemArray (shobjidl_core.h)

  • Artigo

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