Freigeben über

SHGetAttributesFromDataObject-Funktion (shlobj_core.h)

  • Artikel

[SHGetAttributesFromDataObject ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt Anforderungen angegeben sind. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein.]

Ruft angegebene Informationen aus einem Systemdatenobjekt ab.

Syntax

HRESULT SHGetAttributesFromDataObject(
  [in, optional]  IDataObject *pdo,
                  DWORD       dwAttributeMask,
  [out, optional] DWORD       *pdwAttributes,
  [out, optional] UINT        *pcItems
);

Parameter

[in, optional] pdo

Typ: IDataObject*

Das Datenobjekt, aus dem die Informationen abgerufen werden sollen.

dwAttributeMask

Art: DWORD

Mindestens eines der SFGAO-Flags , die angeben, welche Informationen die aufrufende Anwendung abrufen möchte.

[out, optional] pdwAttributes

Typ: DWORD*

Ein Zeiger auf einen DWORD-Wert , der bei erfolgreicher Rückgabe dieser Funktion ein oder mehrere SFGAO-Flags empfängt, die die Attribute unter den angeforderten angeben, die allen Elementen in pdo gemeinsam sind. Dieser Zeiger kann NULL sein, wenn diese Informationen nicht benötigt werden.

[out, optional] pcItems

Typ: UINT*

Ein Zeiger auf einen UINT , der bei erfolgreicher Rückgabe dieser Funktion die Anzahl der PIDLs im Datenobjekt empfängt, auf die pdo verweist. Dieser Zeiger kann NULL sein, wenn diese Informationen nicht benötigt werden.

Rückgabewert

Typ: HRESULT

Diese Funktion kann einen dieser Werte zurückgeben.

Rückgabecode BESCHREIBUNG
S_OK
 Erfolg.
S_FALSE
 Das Objekt ist kein Systemdatenobjekt. In diesem Fall ist pdwAttributes auf 0 festgelegt.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shlobj_core.h (einschließlich Shlobj.h)
Bibliothek Shell32.lib
DLL Shell32.dll (Version 6.0 oder höher)