PSTART_PROTOCOL callback function (routprot.h)
The StartProtocol function initializes the routing protocol's functionality. The router manager uses this function to pass the routing protocol global configuration parameters and a set of API entry points. The protocol uses these entry points to call into the router manager.
Syntax
PSTART_PROTOCOL PstartProtocol;
DWORD PstartProtocol(
[in] HANDLE NotificationEvent,
[in] PSUPPORT_FUNCTIONS SupportFunctions,
[in] LPVOID GlobalInfo,
[in] ULONG StructureVersion,
[in] ULONG StructureSize,
[in] ULONG StructureCount
)
{...}
Parameters
[in] NotificationEvent
Handle to an event object. The routing protocol signals this event when it wants the router manager to retrieve an asynchronous message from the queue maintained by the protocol.
[in] SupportFunctions
Pointer to a SUPPORT_FUNCTIONS structure. The fields of this structure are pointers to functions in the router manager. These functions allow the protocol to access information that spans routing protocols.
[in] GlobalInfo
Pointer to protocol-defined global, as opposed to interface-specific, configuration information. This information is private to the routing protocol.
[in] StructureVersion
Specifies the version of the information structures pointed to by the GlobalInfo parameter. In some cases, this is equal to the version of the routing protocol.
[in] StructureSize
Specifies the size of each of the information structures pointed to by the GlobalInfo parameter. Since some information structures contain variable length members, the routing protocol isn't necessarily able to determine the size of the information from the version.
[in] StructureCount
Specifies a count of the number of information structures pointed to by the GlobalInfo parameter. This parameter is always one.
Return value
If the function succeeds, and the protocol is ready to receive interface information, the return value is NO_ERROR.
If the function fails, the return value is one of the following error codes.
| Value | Description |
|---|---|
|
The attempt to initialize the routing protocol failed. |
|
One of the parameters pointed to by the GlobalInfo parameter is invalid. |
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | None supported |
| Minimum supported server | Windows 2000 Server [desktop apps only] |
| Target Platform | Windows |
| Header | routprot.h |
See also
Routing Protocol Interface Functions