PROPENUMPROCA-Rückruffunktion (winuser.h)

Artikel
03/04/2024

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

Syntax

PROPENUMPROCA Propenumproca;

BOOL Propenumproca(
  HWND unnamedParam1,
  LPCSTR unnamedParam2,
  HANDLE unnamedParam3
)
{...}

Parameter

unnamedParam1

Typ: HWND

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

unnamedParam2

Typ: LPCTSTR

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.

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 PROPENUMPROC 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)