Note

Access to this page requires authorization. You can try signing in or .

Access to this page requires authorization. You can try .

MPR50_ROUTING_CHARACTERISTICS structure (routprot.h)

The MPR_ROUTING_CHARACTERISTICS structure contains information used to register routing protocols with the router manager.

Syntax

typedef struct _MPR50_ROUTING_CHARACTERISTICS {
 DWORD dwVersion;
 DWORD dwProtocolId;
 DWORD fSupportedFunctionality;
 PSTART_PROTOCOL pfnStartProtocol;
 PSTART_COMPLETE pfnStartComplete;
 PSTOP_PROTOCOL pfnStopProtocol;
 PGET_GLOBAL_INFO pfnGetGlobalInfo;
 PSET_GLOBAL_INFO pfnSetGlobalInfo;
 PQUERY_POWER pfnQueryPower;
 PSET_POWER pfnSetPower;
 PADD_INTERFACE pfnAddInterface;
 PDELETE_INTERFACE pfnDeleteInterface;
 PINTERFACE_STATUS pfnInterfaceStatus;
 PGET_INTERFACE_INFO pfnGetInterfaceInfo;
 PSET_INTERFACE_INFO pfnSetInterfaceInfo;
 PGET_EVENT_MESSAGE pfnGetEventMessage;
 PDO_UPDATE_ROUTES pfnUpdateRoutes;
 PCONNECT_CLIENT pfnConnectClient;
 PDISCONNECT_CLIENT pfnDisconnectClient;
 PGET_NEIGHBORS pfnGetNeighbors;
 PGET_MFE_STATUS pfnGetMfeStatus;
 PMIB_CREATE pfnMibCreateEntry;
 PMIB_DELETE pfnMibDeleteEntry;
 PMIB_GET pfnMibGetEntry;
 PMIB_SET pfnMibSetEntry;
 PMIB_GET_FIRST pfnMibGetFirstEntry;
 PMIB_GET_NEXT pfnMibGetNextEntry;
 PMIB_SET_TRAP_INFO pfnMibSetTrapInfo;
 PMIB_GET_TRAP_INFO pfnMibGetTrapInfo;
} MPR50_ROUTING_CHARACTERISTICS;

Members

dwVersion

On input, specifies the version of RRAS currently running.

On output, the routing protocol should specify the version of RRAS that it requires.

The symbol MS_ROUTER_VERSION in the header file Routprot.h is defined to be the RRAS version for a given implementation.

dwProtocolId

Specifies the routing protocol that the router manager requests the DLL to register. (A common name space is used for all protocol families.)

fSupportedFunctionality

On input, specifies the functionality that the router manager supports.

On output, the routing protocol should reset these flags to indicate the subset of functionality that it supports.

This parameter is a combination of one or more of the following values.

Value Meaning
ROUTING
The protocol participates in multi-protocol routing by importing routing table manager APIs. There is one routing table manager that maintains a table for each protocol family (such as IP and IPX).
SERVICES
The protocol assumes responsibility for managing services (such as IPX SAP), and provides Service Table Management APIs.
DEMAND_UPDATE_ROUTES
The protocol is able to perform autostatic updates of routes when requested by the router manager.
DEMAND_UPDATE_SERVICES
The protocol is able to perform autostatic updates of services when requested by the router manager.

pfnStartProtocol

Pointer to an implementation of the StartProtocol function for this routing protocol.

pfnStartComplete

Pointer to an implementation of the StartComplete function for this routing protocol.

pfnStopProtocol

Pointer to an implementation of the StopProtocol function for this routing protocol.

pfnGetGlobalInfo

Pointer to an implementation of the GetGlobalInfo function for this routing protocol.

pfnSetGlobalInfo

Pointer to an implementation of the SetGlobalInfo function for this routing protocol.

pfnQueryPower

Pointer to an implementation of the QueryPower function for this routing protocol.

pfnSetPower

Pointer to an implementation of the SetPower function for this routing protocol.

pfnAddInterface

Pointer to an implementation of the AddInterface function for this routing protocol.

pfnDeleteInterface

Pointer to an implementation of the DeleteInterface function for this routing protocol.

pfnInterfaceStatus

Pointer to an implementation of the InterfaceStatus function for this routing protocol.

pfnGetInterfaceInfo

Pointer to an implementation of the GetInterfaceInfo function for this routing protocol.

pfnSetInterfaceInfo

Pointer to an implementation of the SetInterfaceInfo function for this routing protocol.

pfnGetEventMessage

Pointer to an implementation of the GetEventMessage function for this routing protocol.

pfnUpdateRoutes

Pointer to an implementation of the DoUpdateRoutes function for this routing protocol.

pfnConnectClient

Pointer to an implementation of the ConnectClient function for this routing protocol.

pfnDisconnectClient

Pointer to an implementation of the DisconnectClient function for this routing protocol.

pfnGetNeighbors

Pointer to an implementation of the GetNeighbors function for this routing protocol.

pfnGetMfeStatus

Pointer to an implementation of the GetMfeStatus function for this routing protocol.

pfnMibCreateEntry

Pointer to an implementation of the MibCreate function for this routing protocol.

pfnMibDeleteEntry

Pointer to an implementation of the MibDelete function for this routing protocol.

pfnMibGetEntry

Pointer to an implementation of the MibGet function for this routing protocol.

pfnMibSetEntry

Pointer to an implementation of the MibSet function for this routing protocol.

pfnMibGetFirstEntry

Pointer to an implementation of the MibGetFirst function for this routing protocol.

pfnMibGetNextEntry

Pointer to an implementation of the MibGetNext function for this routing protocol.

pfnMibSetTrapInfo

Pointer to an implementation of the MibSetTrapInfo function for this routing protocol.

pfnMibGetTrapInfo

Pointer to an implementation of the MibGetTrapInfo function for this routing protocol.

Remarks

Most of the members of this structure are pointers to functions implemented in the routing protocol DLL. The routing protocol fills in the address values for these pointers during a call to the RegisterProtocol function.

For a complete description of a particular function pointed to by one of the structure members, see the reference page for that function.

Requirements

Requirement Value
Minimum supported client None supported
Minimum supported server Windows 2000 Server [desktop apps only]
Header routprot.h

See also

Protocol Identifiers

RegisterProtocol

Routing Protocol Interface Reference

Routing Protocol Interface Structures


Feedback

Was this page helpful?

Additional resources