Funzione SHCreateShellItemArray (shobjidl_core.h)

Crea un oggetto matrice di elementi della 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 si specifica psf , 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 termina, questa funzione contiene l'indirizzo di un puntatore all'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	Value
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Header	shobjidl_core.h (includere Shobjidl.h)
Library	OneCore.Lib
DLL	Shell32.dll