IShellFolder::GetAttributesOf-Methode (shobjidl_core.h)
Ruft die Attribute eines oder mehrerer Datei- oder Ordnerobjekte ab, die in dem durch IShellFolder dargestellten Objekt enthalten sind.
Syntax
HRESULT GetAttributesOf(
[in] UINT cidl,
[in] PCUITEMID_CHILD_ARRAY apidl,
[in, out] SFGAOF *rgfInOut
);
Parameter
[in] cidl
Typ: UINT
Die Anzahl der Elemente, aus denen Attribute abgerufen werden sollen.
[in] apidl
Typ: PCUITEMID_CHILD_ARRAY*
Die Adresse eines Arrays von Zeigern auf ITEMIDLIST-Strukturen , von denen jede ein Element relativ zum übergeordneten Ordner eindeutig identifiziert. Jede ITEMIDLIST-Struktur muss genau eine SHITEMID-Struktur gefolgt von einer endenden Null enthalten.
[in, out] rgfInOut
Typ: SFGAOF*
Zeiger auf einen einzelnen ULONG-Wert , der bei einem Eintrag die bitweisen SFGAO-Attribute enthält, die die aufrufende Anwendung anfordert. Beim Beenden enthält dieser Wert die angeforderten Attribute, die allen angegebenen Elementen gemeinsam sind.
Rückgabewert
Typ: HRESULT
Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Um diesen Vorgang zu optimieren, geben Sie keine nicht angegebenen Flags zurück.
Für ein Ordnerobjekt impliziert das SFGAO_BROWSABLE-Attribut , dass der Client an dieses Objekt gebunden werden kann, wie hier in einer allgemeinen Form gezeigt.
IShellFolder::BindToObject(..., pidl, IID_IShellFolder, &psfItem);
Der Client kann dann über diese Anweisung eine IShellView für dieses Element erstellen.
psfItem->CreateViewObject(..., IID_IShellView,...);
Das SFGAO_DROPTARGET-Attribut impliziert, dass der Client eine Bindung an eine instance von IDropTarget für diesen Ordner herstellen kann, indem IShellFolder::GetUIObjectOf aufgerufen wird, wie hier gezeigt.
IShellFolder::GetUIObjectOf(hwnd, 1, &pidl, IID_IDropTarget, NULL, &pv)
Das attribut SFGAO_NONENUMERATED gibt ein Element an, das nicht vom Enumerator zurückgegeben wird, der von der IShellFolder::EnumObjects-Methode erstellt wurde.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | shobjidl_core.h (shobjidl.h einschließen) |
| DLL | Shell32.dll (Version 4.0 oder höher) |