CallWindowProcA-Funktion (winuser.h)

Artikel
08/27/2023

Übergibt Nachrichteninformationen an die angegebene Fensterprozedur.

Syntax

LRESULT CallWindowProcA(
  [in] WNDPROC lpPrevWndFunc,
  [in] HWND    hWnd,
  [in] UINT    Msg,
  [in] WPARAM  wParam,
  [in] LPARAM  lParam
);

Parameter

[in] lpPrevWndFunc

Typ: WNDPROC

Die vorherige Fensterprozedur. Wenn dieser Wert durch Aufrufen der GetWindowLong-Funktion abgerufen wird, wobei der nIndex-Parameter auf GWL_WNDPROC oder DWL_DLGPROC festgelegt ist, handelt es sich tatsächlich entweder um die Adresse einer Fenster- oder Dialogfeldprozedur oder um einen speziellen internen Wert, der nur für CallWindowProc von Bedeutung ist.

[in] hWnd

Typ: HWND

Ein Handle für die Fensterprozedur zum Empfangen der Nachricht.

[in] Msg

Typ: UINT

Die Meldung.

[in] wParam

Typ: WPARAM

Zusätzliche meldungsspezifische Informationen. Der Inhalt dieses Parameters hängt vom Wert des Msg-Parameters ab.

[in] lParam

Typ: LPARAM

Zusätzliche meldungsspezifische Informationen. Der Inhalt dieses Parameters hängt vom Wert des Msg-Parameters ab.

Rückgabewert

Typ: LRESULT

Der Rückgabewert gibt das Ergebnis der Nachrichtenverarbeitung an und hängt von der gesendeten Nachricht ab.

Hinweise

Verwenden Sie die Funktion CallWindowProc für die Fensterunterklasse. In der Regel teilen sich alle Fenster mit derselben Klasse eine Fensterprozedur. Eine Unterklasse ist ein Fenster oder eine Gruppe von Fenstern mit derselben Klasse, deren Nachrichten von einer anderen Fensterprozedur (oder -prozedur) abgefangen und verarbeitet werden, bevor sie an die Fensterprozedur der -Klasse übergeben werden.

Die SetWindowLong-Funktion erstellt die Unterklasse, indem sie die Fensterprozedur ändert, die einem bestimmten Fenster zugeordnet ist, sodass das System die neue Fensterprozedur anstelle der vorherigen aufruft. Eine Anwendung muss alle Nachrichten, die nicht von der neuen Fensterprozedur verarbeitet wurden, durch Aufrufen von CallWindowProc an die vorherige Fensterprozedur übergeben. Dadurch kann die Anwendung eine Kette von Fensterprozeduren erstellen.

Wenn STRICT definiert ist, weist der parameter lpPrevWndFunc den Datentyp WNDPROC auf. Der WNDPROC-Typ wird wie folgt deklariert:

LRESULT (CALLBACK* WNDPROC) (HWND, UINT, WPARAM, LPARAM);

Wenn STRICT nicht definiert ist, weist der lpPrevWndFunc-Parameter den Datentyp FARPROC auf. Der FARPROC-Typ wird wie folgt deklariert:

int (FAR WINAPI * FARPROC) ()

In C gibt die FARPROC-Deklaration eine Rückruffunktion an, die über eine nicht angegebene Parameterliste verfügt. In C++ gibt die leere Parameterliste in der Deklaration jedoch an, dass eine Funktion über keine Parameter verfügt. Diese subtile Unterscheidung kann unvorsichtigen Code unterbrechen. Dies ist eine Möglichkeit, diese Situation zu bewältigen:

#ifdef STRICT 
  WNDPROC MyWindowProcedure 
#else 
  FARPROC MyWindowProcedure 
#endif 
... 
  lResult = CallWindowProc(MyWindowProcedure, ...) ;

Weitere Informationen zu Funktionen, die mit leeren Argumentlisten deklariert wurden, finden Sie unter Die C++-Programmiersprache, Zweite Edition, von Bjarne Stroustrup.

Die Funktion CallWindowProc verarbeitet die Unicode-in-ANSI-Konvertierung. Sie können diese Konvertierung nicht nutzen, wenn Sie die Fensterprozedur direkt aufrufen.

Beispiele

Ein Beispiel finden Sie unter Unterklassen eines Fensters.

Hinweis

Der winuser.h-Header definiert CallWindowProc 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 nicht codierungsneutralem Code 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 (einschließlich Windows.h)
Bibliothek	User32.lib
DLL	User32.dll
APIs	ext-ms-win-ntuser-window-l1-1-4 (eingeführt in Windows 10, Version 10.0.14393)