Freigeben über


PROPENUMPROCEXA-Rückruffunktion (winuser.h)

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 anwendungsdefinierten 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 Eigenschaftsliste aufgezählt wird. Dieser Parameter wird in der Regel hWnd genannt.

unnamedParam2

Typ: LPTSTR-

Die Zeichenfolgenkomponente eines Eigenschaftslisteneintrags. Dies ist die Zeichenfolge, die zusammen mit einem Datenhandle angegeben wurde, als die Eigenschaft über einen Aufruf der SetProp--Funktion zur Eigenschaftenliste des Fensters hinzugefügt wurde. Dieser Parameter wird in der Regel als lpString bezeichnet.

unnamedParam3

Typ: HANDLE

Ein Handle für die Daten. Dieses Handle ist die Datenkomponente eines Eigenschaftenlisteneintrags. Dieser Parameter heißt in der Regel hData.

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. Dieser Parameter heißt in der Regel dwData.

Rückgabewert

Typ: BOOL-

Gibt TRUE- zurück, um die Eigenschaftslistenaufzählung fortzusetzen.

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

Bemerkungen

Anmerkung

Die Parameter werden in der Kopfzeile ohne Namen definiert: typedef BOOL (CALLBACK* PROPENUMPROCEXA)(HWND, LPSTR, HANDLE, ULONG_PTR);. Der Syntaxblock listet sie daher als unnamedParam1 - unnamedParam4. Sie können diese Parameter in Ihrer App benennen. Sie werden jedoch in der Regel wie in den Parameterbeschreibungen dargestellt benannt.

Die folgenden Einschränkungen gelten für diese Rückruffunktion:

  • 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.

Anmerkung

Der winuser.h-Header definiert PROPENUMPROCEX als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante 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
mindestens unterstützte Client- Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server- Windows 2000 Server [nur Desktop-Apps]
Zielplattform- Fenster
Header- winuser.h (enthalten Windows.h)

Siehe auch

Konzeptionelle

Fenstereigenschaften

Referenz-

EnumPropsEx-

RemoveProp-

SetProp-