Funzione RegisterWindowMessageA (winuser.h)

Articolo
03/04/2024

Definisce un nuovo messaggio di finestra che è garantito essere univoco in tutto il sistema. Il valore del messaggio può essere usato durante l'invio o la pubblicazione di messaggi.

Sintassi

UINT RegisterWindowMessageA(
  [in] LPCSTR lpString
);

Parametri

[in] lpString

Tipo: LPCTSTR

Messaggio da registrare.

Valore restituito

Tipo: UINT

Se il messaggio viene registrato correttamente, il valore restituito è un identificatore di messaggio nell'intervallo 0xC000 tramite 0xFFFF.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

La funzione RegisterWindowMessage viene in genere usata per registrare i messaggi per comunicare tra due applicazioni che collaborano.

Se due applicazioni diverse registrano la stessa stringa di messaggio, le applicazioni restituiscono lo stesso valore del messaggio. Il messaggio rimane registrato fino alla fine della sessione.

Usare RegisterWindowMessage solo quando più applicazioni devono elaborare lo stesso messaggio. Per l'invio di messaggi privati all'interno di una classe finestra, un'applicazione può usare qualsiasi intero nell'intervallo WM_USER tramite 0x7FFF. I messaggi in questo intervallo sono privati di una classe finestra, non in un'applicazione. Ad esempio, le classi di controllo predefinite, ad esempio BUTTON, EDIT, LISTBOX e COMBOBOX possono usare valori in questo intervallo.

Esempio

Per un esempio, vedere Ricerca di testo.

Nota

L'intestazione winuser.h definisce RegisterWindowMessage come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winuser.h (include Windows.h)
Libreria	User32.lib
DLL	User32.dll
Set di API	ext-ms-win-ntuser-message-l1-1-0 (introdotto in Windows 8)