GetPropA-Funktion (winuser.h)

Artikel
03/04/2024

Ruft ein Datenhandle aus der Eigenschaftenliste des angegebenen Fensters ab. Die Zeichenfolge identifiziert das abzurufende Handle. Die Zeichenfolge und das Handle müssen der Eigenschaftenliste durch einen vorherigen Aufruf der SetProp-Funktion hinzugefügt worden sein.

Syntax

HANDLE GetPropA(
  [in] HWND   hWnd,
  [in] LPCSTR lpString
);

Parameter

[in] hWnd

Typ: HWND

Ein Handle für das Fenster, dessen Eigenschaftenliste durchsucht werden soll.

[in] lpString

Typ: LPCTSTR

Ein Atom, das eine Zeichenfolge identifiziert. Wenn es sich bei diesem Parameter um ein Atom handelt, muss er mithilfe der GlobalAddAtom-Funktion erstellt worden sein. Das Atom, ein 16-Bit-Wert, muss im Wort mit niedriger Reihenfolge des lpString-Parameters platziert werden. das wort mit hoher Ordnung muss 0 sein.

Rückgabewert

Typ: HANDLE

Wenn die Eigenschaftsliste die Zeichenfolge enthält, ist der Rückgabewert das zugeordnete Datenhandle. Andernfalls ist der Rückgabewert NULL.

Hinweise

Hinweis

Der winuser.h-Header definiert GetProp als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winuser.h (einschließlich Windows.h)
Bibliothek	User32.lib
DLL	User32.dll
APIs	ext-ms-win-ntuser-window-l1-1-0 (eingeführt in Windows 8)