Función RpcServerRegisterIf (rpcdce.h)

Artículo
03/01/2024

La función RpcServerRegisterIf registra una interfaz con la biblioteca en tiempo de ejecución rpc.

Sintaxis

RPC_STATUS RpcServerRegisterIf(
  RPC_IF_HANDLE IfSpec,
  UUID          *MgrTypeUuid,
  RPC_MGR_EPV   *MgrEpv
);

Parámetros

IfSpec

Estructura generada por MIDL que indica la interfaz que se va a registrar.

MgrTypeUuid

Puntero a un UUID de tipo que se va a asociar con el parámetro MgrEpv . Si se especifica un valor de parámetro null (o un UUID nulo) se registra IfSpec con un UUID de tipo nulo.

MgrEpv

Vector de punto de entrada (EPV) de las rutinas de administrador. Para usar el EPV predeterminado generado por MIDL, especifique un valor NULL. Para obtener más información, consulte RPC_MGR_EPV.

Valor devuelto

Devuelve RPC_S_OK si se realiza correctamente.

Nota Para obtener una lista de códigos de error válidos, consulte Rpc Return Values.

Comentarios

Un servidor puede registrar un número ilimitado de interfaces con la biblioteca en tiempo de ejecución rpc. El registro hace que una interfaz esté disponible para los clientes mediante un identificador de enlace para el servidor. Para registrar una interfaz, el código de la aplicación de servidor llama a RpcServerRegisterIf. Para cada implementación de una interfaz que un servidor ofrece, debe registrar un EPV de administrador independiente.

Al llamar a RpcServerRegisterIf, el servidor proporciona la siguiente información:

Especificación de interfaz
La especificación de interfaz es una estructura de datos que genera el compilador MIDL. El servidor especifica la interfaz mediante el parámetro IfSpec .
Tipo de administrador UUID y administrador EPV
El administrador escribe UUID y el administrador EPV determinan qué rutina de administrador se ejecuta cuando un servidor recibe una solicitud de llamada a procedimiento remoto de un cliente.

El servidor especifica el tipo de administrador UUID y EPV mediante los parámetros MgrTypeUuid y MgrEpv . Tenga en cuenta que, al especificar un UUID de tipo administrador no nulo, el servidor también debe llamar a la función RpcObjectSetType para registrar objetos de este tipo no nulo.

Si la aplicación de servidor necesita registrar una interfaz de escucha automática o usar una función de devolución de llamada con fines de autenticación, use RpcServerRegisterIfEx.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	rpcdce.h (incluir Rpc.h)
Library	Rpcrt4.lib
Archivo DLL	Rpcrt4.dll