Partager via

Fonction SHCreateShellItemArray (shobjidl_core.h)

  • Article

Crée un objet de tableau d’éléments Shell.

Syntaxe

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

Paramètres

[in] pidlParent

Type : PCIDLIST_ABSOLUTE

Liste d’ID du dossier parent des éléments spécifiés dans ppidl. Si psf est spécifié, ce paramètre peut être NULL. Si ce pidlParent n’est pas spécifié, il est calculé à partir du paramètre psf à l’aide de IPersistFolder2.

[in] psf

Type : IShellFolder*

Objet de source de données Shell qui est le parent des éléments enfants spécifiés dans ppidl. Si pidlParent est spécifié, ce paramètre peut être NULL.

[in] cidl

Type : UINT

Nombre d’éléments dans le tableau spécifié par ppidl.

[in] ppidl

Type : PCUITEMID_CHILD_ARRAY

Liste des ID d’élément enfant pour lesquels le tableau est créé. Cette valeur peut être NULL.

[out] ppsiItemArray

Type : IShellItemArray**

Lorsque cette fonction est retournée, contient l’adresse d’un pointeur d’interface IShellItemArray .

Valeur retournée

Type : HRESULT

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Spécifications

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
Plateforme cible Windows
En-tête shobjidl_core.h (incluez Shobjidl.h)
DLL Shell32.dll