PGET_EVENT_MESSAGE función de devolución de llamada (routprot.h)

Artículo
03/15/2023

La función GetEventMessage obtiene una entrada de la cola de mensajes del protocolo de enrutamiento. El protocolo de enrutamiento usa la cola para informar al administrador del enrutador de eventos asincrónicos.

Sintaxis

PGET_EVENT_MESSAGE PgetEventMessage;

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

Parámetros

[out] Event

Puntero a un evento. La información sobre este evento se notifica en el mensaje asociado. Tenga en cuenta que esto no es un objeto de evento. (El tipo ROUTING_PROTOCOL_EVENTS se declara en Routprot.h).

Este parámetro recibe uno de los siguientes valores:

Valor	Significado
ROUTER_STOPPED	El protocolo de enrutador se apaga correctamente. El mensaje está vacío para este evento. (Consulte StopProtocol)
SAVE_GLOBAL_CONFIG_INFO	El protocolo de enrutamiento informa de que un agente externo ha cambiado su información de configuración global, es decir, a través de medios distintos de SetGlobalInfo. El protocolo de enrutamiento solicita que el administrador de enrutadores recupere y almacene permanentemente esta información. El mensaje está vacío para este evento.
SAVE_INTERFACE_CONFIG_INFO	El protocolo de enrutamiento informa de que un agente externo ha cambiado la información de configuración asociada a una de sus interfaces, es decir, a través de medios distintos de SetInterfaceInfo. El protocolo de enrutamiento solicita que el administrador de enrutadores recupere y almacene permanentemente esta información. El mensaje contiene el identificador de la interfaz.
UPDATE_COMPLETE	El protocolo de enrutamiento ha completado una solicitud de actualización autostática del administrador del enrutador. El administrador del enrutador convierte la información de enrutamiento recibida en estática. El mensaje contiene el índice de la interfaz en la que se realizó la actualización, el tipo de la información recibida (rutas o servicios) y el campo de resultado, que indica si la actualización se realizó correctamente. Consulte DoUpdateRoutes y DoUpdateServices.

[out] Result

Puntero a una unión MESSAGE . El contenido del mensaje es específico del evento notificado.

Este parámetro es opcional; el autor de la llamada puede especificar NULL para este parámetro.

Valor devuelto

Si la entrada se recupera correctamente, el valor devuelto se NO_ERROR.

Si la cola de mensajes del protocolo de enrutamiento no contiene entradas, el valor devuelto se ERROR_NO_MORE_ITEMS.

Requisitos

Requisito	Value
Cliente mínimo compatible	No se admite ninguno
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	routprot.h