SHGetAttributesFromDataObject-Funktion (shlobj_core.h)

Artikel
03/02/2024

[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)

Share via