BroadcastSystemMessage

La funzione BroadcastSystemMessage Invia un messaggio ai destinatari specificati. I destinatari possono essere applicazioni, i driver installabili, driver di rete, i driver di dispositivo a livello di sistema o qualsiasi combinazione di questi componenti di sistema.

lunga (BroadcastSystemMessage DWORD  dwFlags,  LPDWORD  lpdwRecipients,  UINT  uiMessage,  WPARAM  wParam,  LPARAM  lParam);
 

Parametri

dwFlags

Flag di opzione. Può essere una combinazione dei seguenti valori:

Valore	Significato
BSF_FLUSHDISK	Svuotare il disco dopo ogni destinatario elabora il messaggio.
BSF_FORCEIFHUNG	Continuare a trasmettere il messaggio, anche se è trascorso il periodo di timeout o uno dei destinatari è appeso..
BSF_IGNORECURRENTTASK	Non inviare il messaggio a windows che appartengono all'attività corrente. Questo impedisce un'applicazione di ricevere il proprio messaggio.
BSF_NOHANG	Forza un'applicazione appeso a time out. Se uno dei destinatari timeout, non continuare trasmette il messaggio.
BSF_NOTIMEOUTIFNOTHUNG	Attendere una risposta al messaggio, fintanto che il destinatario non è appeso. Fare non time out.
BSF_POSTMESSAGE	Inviare il messaggio. Non utilizzare in combinazione con BSF_QUERY.
BSF_QUERY	Inviare il messaggio a un destinatario in un momento, l'invio a un destinatario successivo solo se il destinatario corrente restituisce TRUE.

lpdwRecipients

Puntatore a una variabile che contiene e riceve le informazioni sui destinatari del messaggio. La variabile può essere una combinazione dei seguenti valori:

Valore	Significato
BSM_ALLCOMPONENTS	Trasmesso a tutte le componenti del sistema.
BSM_ALLDESKTOPS	Windows NT: Trasmettono tutti i desktop. Richiede il privilegio SE_TCB_NAME.
BSM_APPLICATIONS	In onda alle applicazioni.
BSM_INSTALLABLEDRIVERS	Windows 95: Trasmissione a installabili driver.
BSM_NETDRIVER	Windows 95: Trasmessi ai driver di rete.
BSM_VXDS	Windows 95: Trasmesso a tutti i driver di dispositivo a livello di sistema.

Quando la funzione termina, questa variabile riceve una combinazione di questi valori, individuando i destinatari che effettivamente ricevuto il messaggio.

Se questo parametro è NULL, la funzione delle trasmissioni tutti i componenti.

uiMessage

Identificatore del messaggio di sistema.

wParam

valore specifico del messaggio a 32-bit.

lParam

valore specifico del messaggio a 32-bit.

Valori restituiti

Se la funzione ha esito positivo, il valore restituito è un valore positivo.

Se la funzione è in grado di trasmettere il messaggio, il valore restituito è – 1.

Se il parametro dwFlags è BSF_QUERY e almeno un destinatario BROADCAST_QUERY_DENY ha restituito il messaggio corrispondente, il valore restituito è zero. Per ottenere informazioni di errore estese, chiamare GetLastError.

Osservazioni

Se BSF_QUERY non viene specificato, la funzione Invia il messaggio specificato a tutti i destinatari richiesti, ignorando i valori restituiti da tali destinatari.

Descrizione

nbsp; Windows &NT: richiede una versione 4.0 o successive.
Windows:Richiede Windows 95 o versioni successive.
Windows CE:Non supportato.
Intestazione:Dichiarati in winuser.
Importare librerie:Utilizzare user32.lib.
Unicode:Implementato come versioni Unicode e ANSI su Windows NT.

Vedi anche

Messaggi e panoramica delle code di messaggi, messaggio e funzioni di coda dei messaggi

Rimedio: Inserire il CD-ROM CD di MSDN Library.

Index