PSTART_PROTOCOL función de devolución de llamada (routprot.h)
La función StartProtocol inicializa la funcionalidad del protocolo de enrutamiento. El administrador de enrutadores usa esta función para pasar los parámetros de configuración global del protocolo de enrutamiento y un conjunto de puntos de entrada de API. El protocolo utiliza estos puntos de entrada para llamar al administrador del enrutador.
Sintaxis
PSTART_PROTOCOL PstartProtocol;
DWORD PstartProtocol(
[in] HANDLE NotificationEvent,
[in] PSUPPORT_FUNCTIONS SupportFunctions,
[in] LPVOID GlobalInfo,
[in] ULONG StructureVersion,
[in] ULONG StructureSize,
[in] ULONG StructureCount
)
{...}
Parámetros
[in] NotificationEvent
Identificador de un objeto de evento. El protocolo de enrutamiento indica este evento cuando quiere que el administrador del enrutador recupere un mensaje asincrónico de la cola mantenida por el protocolo.
[in] SupportFunctions
Puntero a una estructura de SUPPORT_FUNCTIONS . Los campos de esta estructura son punteros a funciones en el administrador del enrutador. Estas funciones permiten al protocolo acceder a la información que abarca los protocolos de enrutamiento.
[in] GlobalInfo
Puntero a global definido por protocolo, en lugar de información de configuración específica de la interfaz. Esta información es privada para el protocolo de enrutamiento.
[in] StructureVersion
Especifica la versión de las estructuras de información a las que apunta el parámetro GlobalInfo . En algunos casos, esto es igual a la versión del protocolo de enrutamiento.
[in] StructureSize
Especifica el tamaño de cada una de las estructuras de información a las que apunta el parámetro GlobalInfo . Dado que algunas estructuras de información contienen miembros de longitud variable, el protocolo de enrutamiento no es necesariamente capaz de determinar el tamaño de la información de la versión.
[in] StructureCount
Especifica un recuento del número de estructuras de información a las que apunta el parámetro GlobalInfo . Este parámetro siempre es uno.
Valor devuelto
Si la función se ejecuta correctamente y el protocolo está listo para recibir información de interfaz, el valor devuelto es NO_ERROR.
Si se produce un error en la función, el valor devuelto es uno de los siguientes códigos de error.
| Valor | Descripción |
|---|---|
|
Error al intentar inicializar el protocolo de enrutamiento. |
|
Uno de los parámetros a los que apunta el parámetro GlobalInfo no es válido. |
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 |
Consulte también
Funciones de interfaz de protocolo de enrutamiento