IShellFolder::GetAttributesOf-Methode (shobjidl_core.h)

  • Artikel

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)

Weitere Informationen

IShellFolder

IShellFolder2