PROPENUMPROCEXA-Rückruffunktion (winuser.h)

Artikel
08/27/2023

Anwendungsdefinierte Rückruffunktion, die mit der EnumPropsEx-Funktion verwendet wird. Die Funktion empfängt Eigenschaftseinträge aus der Eigenschaftenliste eines Fensters. Der PROPENUMPROCEX-Typ definiert einen Zeiger auf diese Rückruffunktion. PropEnumProcEx ist ein Platzhalter für den anwendungsdefinierte Funktionsnamen.

Syntax

PROPENUMPROCEXA Propenumprocexa;

BOOL Propenumprocexa(
  HWND unnamedParam1,
  LPSTR unnamedParam2,
  HANDLE unnamedParam3,
  ULONG_PTR unnamedParam4
)
{...}

Parameter

unnamedParam1

Typ: HWND

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

unnamedParam2

Typ: LPTSTR

Die Zeichenfolgenkomponente eines Eigenschaftenlisteneintrags. Dies ist die Zeichenfolge, die zusammen mit einem Datenhandle angegeben wurde, als die Eigenschaft der Eigenschaftenliste des Fensters über einen Aufruf der SetProp-Funktion hinzugefügt wurde.

unnamedParam3

Typ: HANDLE

Ein Handle für die Daten. Dieses Handle ist die Datenkomponente eines Eigenschaftenlisteneintrags.

unnamedParam4

Typ: ULONG_PTR

Anwendungsdefinierte Daten. Dies ist der Wert, der als lParam-Parameter des Aufrufs von EnumPropsEx angegeben wurde, der die Enumeration initiiert hat.

Rückgabewert

Typ: BOOL

Geben Sie TRUE zurück, um die Eigenschaftslistenaufzählung fortzusetzen.

Gibt FALSE zurück, um die Eigenschaftslistenaufzählung zu beenden.

Hinweise

Für diese Rückruffunktion gelten die folgenden Einschränkungen:

Die Rückruffunktion kann die RemoveProp-Funktion aufrufen. RemoveProp kann jedoch nur die Eigenschaft entfernen, die über die Parameter der Rückruffunktion an die Rückruffunktion übergeben wird.
Die Rückruffunktion sollte nicht versuchen, Eigenschaften hinzuzufügen.

Hinweis

Der winuser.h-Header definiert PROPENUMPROCEX 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


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)