Función RpcEpRegister (rpcdce.h)
La función RpcEpRegister agrega o reemplaza la información de dirección del servidor en la base de datos local de mapa de puntos de conexión.
Sintaxis
RPC_STATUS RpcEpRegister(
RPC_IF_HANDLE IfSpec,
RPC_BINDING_VECTOR *BindingVector,
UUID_VECTOR *UuidVector,
RPC_CSTR Annotation
);
Parámetros
IfSpec
Interfaz para registrarse con la base de datos local de mapa de puntos de conexión.
BindingVector
Puntero a un vector de identificadores de enlace sobre los que el servidor puede recibir llamadas a procedimientos remotos.
UuidVector
Puntero a un vector de UUID de objeto ofrecidos por el servidor. La aplicación de servidor construye este vector. Un valor de argumento NULL indica que no hay UUID de objeto que se van a registrar.
Annotation
Puntero al comentario de cadena de caracteres aplicado a cada elemento entre productos agregado a la base de datos local del mapa de puntos de conexión. La cadena puede tener hasta 64 caracteres, incluido el carácter de terminación NULL. Especifique un valor NULL o una cadena terminada en NULL ("\0") si no hay ninguna cadena de anotación.
Las aplicaciones solo usan la cadena de anotación para obtener información. RPC no usa esta cadena para determinar con qué instancia de servidor se comunica un cliente o para enumerar elementos de la base de datos de mapa de punto de conexión.
Valor devuelto
Valor | Significado |
---|---|
|
La llamada se realizó correctamente. |
|
Sin enlaces. |
|
El identificador de enlace no era válido. |
|
Este era el tipo incorrecto de enlace para la operación. |
Comentarios
La función RpcEpRegister agrega o reemplaza entradas en la base de datos de mapa de puntos de conexión del host local. Para una entrada de base de datos existente que coincida con la especificación de interfaz proporcionada, el identificador de enlace y el UUID de objeto, esta función reemplaza el punto de conexión de la entrada por el punto de conexión en el identificador de enlace proporcionado.
Un servidor puede usar RpcEpRegister y RpcEpRegisterNoReplace para registrar entradas en la base de datos del asignador de puntos de conexión. Antes de Windows 2000, había dos funciones disponibles para permitir que un servidor sobrescriba entradas obsoletas en la base de datos del asignador de puntos de conexión dejó de instancias de servidor anteriores que ya no se están ejecutando. La base de datos del asignador de puntos de conexión quita automáticamente las entradas registradas por una instancia de servidor en cuanto el servidor deja de funcionar. Sin embargo, los servidores no pueden reemplazar las entradas del asignador de puntos de conexión de otro servidor con fines de seguridad. Por lo tanto, RpcEpRegister y RpcEpRegisterNoReplace realizan en gran medida la misma funcionalidad.
Una aplicación de servidor llama a RpcEpRegister para registrar los puntos de conexión especificados mediante una llamada a cualquiera de las funciones siguientes:
- RpcServerUseAllProtseqs
- RpcServerUseProtseq
- RpcServerUseProtseqEp
- RpcServerUseAllProtseqsIf
- RpcServerUseProtseqIf
Si se usa una secuencia de protocolo sin especificar un punto de conexión, la biblioteca en tiempo de ejecución rpc genera automáticamente un punto de conexión dinámico. En este caso, el servidor puede llamar a RpcServerInqBindings seguido de RpcEpRegister para que esté disponible para varios clientes. De lo contrario, el servidor iniciado automáticamente solo se conoce al cliente para el que se inició el servidor. Cada elemento agregado a la base de datos de mapa de puntos de conexión contiene lógicamente lo siguiente:
- UUID de interfaz
- Versión de interfaz (principal y secundaria)
- Identificador de enlace
- UUID de objeto (opcional)
- Anotación (opcional)
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 (include Rpc.h) |
Library | Rpcrt4.lib |
Archivo DLL | Rpcrt4.dll |