IShellFolder::GetAttributesOf, méthode (shobjidl_core.h)
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) |