PostThreadMessage

Funkcja PostThreadMessage umieszcza (stanowiska) wiadomość w kolejce określonego wątku i następnie zwraca, bez oczekiwania na przetwarzanie wiadomości wątku.

(BOOL PostThreadMessage DWORD  idThread, / / wątku identyfikatorUINTMsg, / / wiadomości do księgowaniaWPARAMwParam, / / po raz pierwszy wiadomości parametrFIKCYJNYMIfikcyjnymi / / drugi parametr message);
 

Parametry

idThread

Identyfikator wątku wątku, na które zostanie zaksięgowany wiadomości.

Funkcja nie powiedzie się, jeśli określony wątek nie kolejki wiadomości. System tworzy wątku wiadomości kolejki, gdy wątek pozwala jej pierwsze wywołanie do jednej z funkcji użytkownika systemu Win32 lub interfejsu GDI. Aby uzyskać więcej informacji zobacz sekcję Spostrzeżenia.

Msg

Określa typ wiadomości mają być księgowane.

wParam

Określa dodatkowe informacje specyficzne dla wiadomości.

fikcyjnymi

Określa dodatkowe informacje specyficzne dla wiadomości.

Zwraca wartości

Jeśli funkcja, wartość zwracany jest różna od zera.

Jeśli funkcja zawiedzie, wartość zwracany jest równa zero. Aby uzyskać rozszerzonych informacji o błędach, należy wywołać GetLastError. Funkcja GetLastError zwraca ERROR_INVALID_THREAD_ID, jeśli idThread nie ma identyfikatora wątku ważne lub jeżeli wątek określony przez idThread ma kolejkę wiadomości.

Uwagi

Wątek, na którym jest księgowana wiadomości należy utworzyć kolejkę wiadomości, lub też wywołanie PostThreadMessage nie powiedzie się. Użyj jednej z następujących metod do obsługi tej sytuacji:

• Wywołanie funkcji PostThreadMessage. Jeśli go nie powiedzie się, wywołania funkcji uśpienia i wywołanie PostThreadMessage ponownie. Powtarzaj aż powiedzie się PostThreadMessage.
• Utwórz obiekt zdarzenia, a następnie utworzyć wątku. Użycie funkcji WaitForSingleObject oczekiwania na zdarzenia należy ustawić stan sygnalizacji przed wywołaniem metody PostThreadMessage. W wątku, na które zostanie zaksięgowany wiadomości wywołanie PeekMessage(amp; msg, NULL, WM_USER, WM_USER, PM_NOREMOVE), aby zmusić system, aby utworzyć kolejkę wiadomości. Zestaw zdarzeń, aby wskazać, że wątek jest gotowy do odbierania wiadomości ogłoszone.

Wątek, na którym jest księgowana wiadomości pobiera komunikat, wywołując funkcję GetMessage lub PeekMessage . Członek hwnd zwracane struktury MSG ma wartość NULL.

Skrócone informacje

nbsp; Windows &NT: wymagana wersja 3.1 lub nowsza.
Systemu Windows:Wymaga systemu Windows 95 lub nowszego.
Systemu Windows CE:Wymaga wersja 1.0 lub nowsza.
Nagłówka:Zadeklarowane w pliku winuser.h.
Importowanie biblioteki:Należy użyć user32.lib.
Unicode:Implementowane jako wersje Unicode i ANSI w systemie Windows NT.

Zobacz też

Omówienie kolejek wiadomości i wiadomości, wiadomości i funkcje kolejek wiadomości, GetCurrentThreadId, GetMessage, GetWindowThreadProcessId, MSG, PeekMessage, PostMessage, , stan uśpienia, WaitForSingleObject