SHGetAttributesFromDataObject-Funktion (shlobj_core.h)
[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 |
---|---|
|
Erfolg. |
|
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) |