IShellFolder::GetAttributesOf, méthode (shobjidl_core.h)

  • Article

Obtient les attributs d’un ou plusieurs objets fichier ou dossier contenus dans l’objet représenté par IShellFolder.

Syntaxe

HRESULT GetAttributesOf(
  [in]      UINT                  cidl,
  [in]      PCUITEMID_CHILD_ARRAY apidl,
  [in, out] SFGAOF                *rgfInOut
);

Paramètres

[in] cidl

Type : UINT

Nombre d’éléments à partir desquels récupérer des attributs.

[in] apidl

Type : PCUITEMID_CHILD_ARRAY*

Adresse d’un tableau de pointeurs vers des structures ITEMIDLIST , chacune d’elles identifiant de manière unique un élément relatif au dossier parent. Chaque structure ITEMIDLIST doit contenir exactement une structure SHITEMID suivie d’un zéro de fin.

[in, out] rgfInOut

Type : SFGAOF*

Pointeur vers une valeur ULONG unique qui, lors de l’entrée, contient les attributs SFGAO au niveau du bit que l’application appelante demande. À la sortie, cette valeur contient les attributs demandés communs à tous les éléments spécifiés.

Valeur retournée

Type : HRESULT

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

Remarques

Pour optimiser cette opération, ne retournez pas d’indicateurs non spécifiés.

Pour un objet folder, l’attribut SFGAO_BROWSABLE implique que le client peut établir une liaison à cet objet, comme indiqué dans un formulaire général ici.

IShellFolder::BindToObject(..., pidl, IID_IShellFolder, &psfItem);

Le client peut ensuite créer un IShellView sur cet élément via cette instruction.

psfItem->CreateViewObject(..., IID_IShellView,...);

L’attribut SFGAO_DROPTARGET implique que le client peut établir une liaison à un instance de IDropTarget pour ce dossier en appelant IShellFolder::GetUIObjectOf comme indiqué ici.

IShellFolder::GetUIObjectOf(hwnd, 1, &pidl, IID_IDropTarget, NULL, &pv)

L’attribut SFGAO_NONENUMERATED indique un élément qui n’est pas retourné par l’énumérateur créé par la méthode IShellFolder::EnumObjects .

Configuration requise

   
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête shobjidl_core.h (incluez Shobjidl.h)
DLL Shell32.dll (version 4.0 ou ultérieure)

Voir aussi

IShellFolder

IShellFolder2