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

La función RegisterProtocol registra el protocolo de enrutamiento con el administrador del enrutador. También informa al administrador del enrutador de la funcionalidad que admite el protocolo de enrutamiento.

Sintaxis

PREGISTER_PROTOCOL PregisterProtocol;

DWORD PregisterProtocol(
  [in, out] PMPR_ROUTING_CHARACTERISTICS pRoutingChar,
  [in, out] PMPR_SERVICE_CHARACTERISTICS pServiceChar
)
{...}

Parámetros

[in, out] pRoutingChar

En la entrada, puntero a una estructura de MPR_ROUTING_CHARACTERISTICS .

En la salida, recibe punteros a las funciones implementadas para el protocolo de enrutamiento.

Consulte la página de referencia de la estructura de MPR_ROUTING_CHARACTERISTICS para obtener más información sobre cómo usarla con la función RegisterProtocol .

[in, out] pServiceChar

En la entrada, puntero a una estructura de MPR_SERVICE_CHARACTERISTICS .

En la salida, recibe punteros a las funciones implementadas para el protocolo de enrutamiento.

Consulte la página de referencia de la estructura de MPR_SERVICE_CHARACTERISTICS para obtener más información sobre cómo usarla con la función RegisterProtocol .

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es NO_ERROR.

Si se produce un error en la función, se ERROR_NOT_SUPPORTED el valor devuelto.

Comentarios

Todos los archivos DLL de protocolo de enrutamiento deben rellenar los valores de la estructura de MPR_ROUTING_CHARACTERISTICS .

Los archivos DLL de protocolo de enrutamiento que proporcionan servicios deben rellenar los valores de la estructura MPR_SERVICE_CHARACTERISTICS . Si un archivo DLL de protocolo de enrutamiento no proporciona servicios, debe rellenar cero para el miembro fSupportedFunctionality de esta estructura, pero no debe rellenar los valores de los demás miembros.

Los protocolos de enrutamiento se implementan en archivos DLL en modo de usuario. Un único archivo DLL puede implementar varios protocolos de enrutamiento. Por lo tanto, el administrador de enrutadores puede llamar a RegisterProtocol varias veces, una vez para cada protocolo de enrutamiento implementado en el archivo DLL.

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

MPR_ROUTING_CHARACTERISTICS

MPR_SERVICE_CHARACTERISTICS

Funciones de interfaz de protocolo de enrutamiento

Referencia de la interfaz del protocolo de enrutamiento