fonction CIDLData_CreateFromIDArray (shlobj_core.h)

[CIDLData_CreateFromIDArray est disponible pour une utilisation dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il peut être modifié ou indisponible dans les versions suivantes.]

Crée un objet de données avec le pointeur vtable par défaut.

Syntaxe

SHSTDAPI CIDLData_CreateFromIDArray(
  [in]  PCIDLIST_ABSOLUTE        pidlFolder,
  [in]  UINT                     cidl,
  [in]  PCUIDLIST_RELATIVE_ARRAY apidl,
  [out] IDataObject              **ppdtobj
);

Paramètres

[in] pidlFolder

Type : PCIDLIST_ABSOLUTE

IDLIST complet pour la racine des éléments spécifiés dans apidl.

[in] cidl

Type : UINT

Nombre d’entrées dans le tableau apidl .

[in] apidl

Type : PCUIDLIST_RELATIVE_ARRAY

Tableau d’ID d’élément relatif à pidlFolder. En règle générale, apidl est un tableau d’ID enfants et pidlFolder est un PIDL complet pour ces éléments. Toutefois, pidlFolder peut être un PIDL null (IDLISTs de bureau). Dans ce cas, apidl peut contenir des listes d’ID complètes.

[out] ppdtobj

Type : IDataObject**

Adresse d’un pointeur vers l’objet qui implémente IDataObject.

Valeur retournée

Type : HRESULT

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

Remarques

L’objet de données créé par cette fonction offre l’identificateur de format du Presse-papiers Shell CFSTR_SHELLIDLIST. Cet objet de données prend également en charge les appels IDataObject ::SetData pour récupérer d’autres formats du Presse-papiers.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shlobj_core.h (inclure Shlobj.h)
Bibliothèque	Shell32.lib
DLL	Shell32.dll (version 5.0 ou ultérieure)
Ensemble d’API	ext-ms-win-shell-shell32-l1-2-1 (introduit dans Windows 10, version 10.0.10240)

Voir aussi

SHCreateDataObject