PGET_EVENT_MESSAGE funzione di callback (routprot.h)

Articolo
03/01/2024

La funzione GetEventMessage ottiene una voce dalla coda dei messaggi del protocollo di routing. Il protocollo di routing usa la coda per informare il gestore router di eventi asincroni.

Sintassi

PGET_EVENT_MESSAGE PgetEventMessage;

DWORD PgetEventMessage(
  [out] ROUTING_PROTOCOL_EVENTS *Event,
  [out] MESSAGE *Result
)
{...}

Parametri

[out] Event

Puntatore a un evento. Le informazioni su questo evento vengono segnalate nel messaggio associato. Si noti che non si tratta di un oggetto evento. Il tipo ROUTING_PROTOCOL_EVENTS è dichiarato in Routprot.h.

Questo parametro riceve uno dei valori seguenti:

Valore	Significato
ROUTER_STOPPED	Il protocollo router viene arrestato correttamente. Il messaggio è vuoto per questo evento. (Vedere StopProtocol)
SAVE_GLOBAL_CONFIG_INFO	Il protocollo di routing segnala che le informazioni di configurazione globali sono state modificate da un agente esterno, ovvero tramite mezzi diversi da SetGlobalInfo. Il protocollo di routing richiede che il gestore router recuperi e archivii definitivamente queste informazioni. Il messaggio è vuoto per questo evento.
SAVE_INTERFACE_CONFIG_INFO	Il protocollo di routing segnala che le informazioni di configurazione associate a una delle relative interfacce sono state modificate da un agente esterno, ovvero tramite diversi da SetInterfaceInfo. Il protocollo di routing richiede che il gestore router recuperi e archivii definitivamente queste informazioni. Il messaggio contiene l'ID dell'interfaccia.
UPDATE_COMPLETE	Il protocollo di routing ha completato una richiesta di aggiornamento automatico dal gestore router. Il gestore router converte le informazioni di routing ricevute in statiche. Il messaggio contiene l'indice dell'interfaccia in cui è stato eseguito l'aggiornamento, il tipo di informazioni ricevute (route o servizi) e il campo del risultato, che indica se l'aggiornamento è riuscito. Vedere DoUpdateRoutes e DoUpdateServices.

[out] Result

Puntatore a un'unione MESSAGE . Il contenuto del messaggio è specifico dell'evento segnalato.

Questo parametro è facoltativo; il chiamante può specificare NULL per questo parametro.

Valore restituito

Se la voce viene recuperata correttamente, il valore restituito viene NO_ERROR.

Se la coda di messaggi del protocollo di routing non contiene voci, il valore restituito è ERROR_NO_MORE_ITEMS.

Requisiti

Requisito	Valore
Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	routprot.h