EnumPropsA-Funktion (winuser.h)
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 |
Siehe auch
Konzept
Referenz