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 no ppidl. Se psf for especificado, esse parâmetro poderá ser NULL. Se esse pidlParent não for especificado, ele será calculado a partir 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 .

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 .

Requirements