EnumPropsA-Funktion (winuser.h)

Artikel
03/06/2024

Listet alle Einträge in der Eigenschaftenliste eines Fensters auf, indem sie einzeln an die angegebene Rückruffunktion übergeben werden. EnumProps wird fortgesetzt, bis der letzte Eintrag aufgelistet ist oder die Rückruffunktion FALSE zurückgibt.

Verwenden Sie die Funktion EnumPropsEx , um anwendungsdefinierte Daten an die Rückruffunktion zu übergeben.

Syntax

int EnumPropsA(
  [in] HWND          hWnd,
  [in] PROPENUMPROCA lpEnumFunc
);

Parameter

[in] hWnd

Typ: HWND

Ein Handle für das Fenster, dessen Eigenschaftenliste aufgezählt werden soll.

[in] lpEnumFunc

Typ: PROPENUMPROC

Ein Zeiger auf die Rückruffunktion. Weitere Informationen zur Rückruffunktion finden Sie in der PropEnumProc-Funktion .

Rückgabewert

Typ: int

Der Rückgabewert gibt den letzten Wert an, der von der Rückruffunktion zurückgegeben wird. Es ist -1, wenn die Funktion keine Eigenschaft für die Enumeration gefunden hat.

Hinweise

Eine Anwendung kann nur die eigenschaften entfernen, die sie hinzugefügt hat. Eigenschaften, die von anderen Anwendungen oder vom System selbst hinzugefügt wurden, dürfen nicht entfernt werden.

Hinweis

Der winuser.h-Header definiert EnumProps 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 Code, der nicht Codierungsneutral ist, 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 (windows.h einschließen)
Bibliothek	User32.lib
DLL	User32.dll