Funzione SHCreateShellItemArray (shobjidl_core.h)

Crea un oggetto matrice di elementi shell.

Sintassi

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

Parametri

[in] pidlParent

Tipo: PCIDLIST_ABSOLUTE

Elenco ID della cartella padre degli elementi specificati in ppidl. Se psf è specificato, questo parametro può essere NULL. Se questo pidlParent non viene specificato, viene calcolato dal parametro psf usando IPersistFolder2.

[in] psf

Tipo: IShellFolder*

Oggetto origine dati shell padre degli elementi figlio specificati in ppidl. Se viene specificato pidlParent , questo parametro può essere NULL.

[in] cidl

Tipo: UINT

Numero di elementi nella matrice specificata da ppidl.

[in] ppidl

Tipo: PCUITEMID_CHILD_ARRAY

Elenco di ID elemento figlio per cui viene creata la matrice. Questo valore può essere NULL.

[out] ppsiItemArray

Tipo: IShellItemArray**

Quando questa funzione restituisce, contiene l'indirizzo di un puntatore dell'interfaccia IShellItemArray .

Valore restituito

Tipo: HRESULT

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shobjidl_core.h (include Shobjidl.h)
DLL	Shell32.dll