[This is preliminary documentation and subject to change.]
The GetEventMessage function gets an entry from the routing protocol's message queue. The routing protocol uses the queue to inform the router manager of asynchronous events.
DWORD GetEventMessage(
ROUTING_PROTOCOL_EVENTS * Event,
// address of message queue entry
MESSAGE * Result // event dependent message
);
Event values
Value | Description |
---|---|
ROUTER_STOPPED | The router protocol shutdown successfully. The message is empty for this event. (See StopProtocol) |
SAVE_GLOBAL_CONFIG_INFO | The routing protocol reports that its global configuration information has been changed by an external agent, that is,, through means other than SetGlobalInfo. The routing protocol requests that the router manager retrieve and permanently store this information. The message is empty for this event. |
SAVE_INTERFACE_CONFIG_INFO | The routing protocol reports that the configuration information associated with one of its interfaces has been changed by an external agent, that is, through means other than SetInterfaceConfigInfo. The routing protocol requests that the router manager retrieve and permanently store this information. The message contains the ID of the interface. |
UPDATE_COMPLETE | The routing protocol has completed an autostatic update request from the router manager. The router manager can proceed with converting received routing information to static. The message contains the index of the interface on which the update was performed, the type of the information received (routes or services), and the result field which indicates whether the update succeeded. See DoUpdateRoutes and DoUpdateServices. |
This parameter is optional; the caller may specify NULL for this parameter.
Windows NT: Use version 5.0 and later.
Windows: Unsupported.
Windows CE: Unsupported.
Header: Declared in routprot.h.
Import Library: user-defined.
DoUpdateRoutes, DoUpdateServices, GetEventMessage Sample, MESSAGE, SetGlobalInfo, SetInterfaceConfigInfo, StopProtocol