SendMessageTimeoutA-Funktion (winuser.h)

Sendet die angegebene Nachricht an ein oder mehrere Fenster.

Syntax

LRESULT SendMessageTimeoutA(
  [in]            HWND       hWnd,
  [in]            UINT       Msg,
  [in]            WPARAM     wParam,
  [in]            LPARAM     lParam,
  [in]            UINT       fuFlags,
  [in]            UINT       uTimeout,
  [out, optional] PDWORD_PTR lpdwResult
);

Parameter

[in] hWnd

Typ: HWND-

Ein Handle für das Fenster, dessen Fensterprozedur die Nachricht empfängt.

Wenn dieser Parameter HWND_BROADCAST ((HWND)0xffff ist), wird die Nachricht an alle Fenster der obersten Ebene im System gesendet, einschließlich deaktivierter oder unsichtbarer nicht zugeordneter Fenster. Die Funktion wird erst zurückgegeben, wenn für jedes Fenster ein Timeout aufgetreten ist. Daher kann die Gesamtwartezeit bis zum Wert uTimeout multipliziert mit der Anzahl der Fenster der obersten Ebene sein.

[in] Msg

Typ: UINT-

Die zu sendende Nachricht.

Listen der vom System bereitgestellten Nachrichten finden Sie unter System-Defined Nachrichten.

[in] wParam

Typ: WPARAM-

Alle zusätzlichen nachrichtenspezifischen Informationen.

[in] lParam

Typ: LPARAM-

Alle zusätzlichen nachrichtenspezifischen Informationen.

[in] fuFlags

Typ: UINT-

Das Verhalten dieser Funktion. Dieser Parameter kann einen oder mehrere der folgenden Werte sein.

[in] uTimeout

Typ: UINT-

Die Dauer des Timeoutzeitraums in Millisekunden. Wenn es sich bei der Nachricht um eine Übertragungsnachricht handelt, kann jedes Fenster den vollständigen Timeoutzeitraum verwenden. Wenn Sie z. B. einen Zeitraum von fünf Sekunden angeben und drei Fenster der obersten Ebene vorhanden sind, die die Nachricht nicht verarbeiten können, können Sie bis zu einer Verzögerung von 15 Sekunden haben.

[out, optional] lpdwResult

Typ: PDWORD_PTR

Das Ergebnis der Nachrichtenverarbeitung. Der Wert dieses Parameters hängt von der angegebenen Nachricht ab.

Rückgabewert

Typ: LRESULT-

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null. SendMessageTimeout- enthält keine Informationen zu einzelnen Fensteranzeigen, wenn HWND_BROADCAST verwendet wird.

Wenn die Funktion fehlschlägt oder ein Zeitüberschreitung auftritt, lautet der Rückgabewert 0. Beachten Sie, dass die Funktion nicht immer SetLastError- beim Fehler aufruft. Wenn der Grund für fehler wichtig für Sie ist, rufen Sie SetLastError(ERROR_SUCCESS) auf, bevor Sie SendMessageTimeout aufrufen. Wenn die Funktion 0 zurückgibt und GetLastError ERROR_SUCCESS zurückgibt, behandeln Sie sie als generischen Fehler.

Bemerkungen

Die Funktion ruft die Fensterprozedur für das angegebene Fenster auf, und wenn das angegebene Fenster zu einem anderen Thread gehört, wird erst zurückgegeben, wenn die Fensterprozedur die Nachricht verarbeitet hat oder der angegebene Timeoutzeitraum abgelaufen ist. Wenn das Fenster, das die Nachricht empfängt, zur gleichen Warteschlange wie der aktuelle Thread gehört, wird die Fensterprozedur direkt aufgerufen – der Timeoutwert wird ignoriert.

Diese Funktion ist der Ansicht, dass ein Thread nicht reagiert, wenn er nicht GetMessage- oder eine ähnliche Funktion innerhalb von fünf Sekunden aufgerufen hat.

Das System marshallt nur für Systemmeldungen (die im Bereich 0 bis (WM_USER-1)). Um andere Nachrichten (die >= WM_USER) an einen anderen Prozess zu senden, müssen Sie benutzerdefinierte Marshalling durchführen.

Anforderungen

Siehe auch

Konzeptionelle

GetMessage-

InSendMessage-

Nachrichten- und Nachrichtenwarteschlangen

PostMessage-

Referenz-

SendDlgItemMessage-

SendMessage-

SendMessageCallback-

SendNotifyMessage-