Compartir a través de

Función RpcEpRegisterW (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 RpcEpRegisterW(
  RPC_IF_HANDLE      IfSpec,
  RPC_BINDING_VECTOR *BindingVector,
  UUID_VECTOR        *UuidVector,
  RPC_WSTR           Annotation
);

Parámetros

IfSpec

Interfaz para registrarse con la base de datos de mapa de puntos de conexión local.

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 de mapa de puntos de conexión local. 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 usan la cadena de anotación solo para obtener información. RPC no usa esta cadena para determinar con qué instancia de servidor se comunica un cliente o para enumerar elementos en la base de datos de mapa de puntos de conexión.

Valor devuelto

Valor Significado
RPC_S_OK
 La llamada se realizó correctamente.
RPC_S_NO_BINDINGS
 Sin enlaces.
RPC_S_INVALID_BINDING
 El identificador de enlace no era válido.
RPC_S_WRONG_KIND_OF_BINDING
 Este era el tipo incorrecto de enlace para la operación.
 
Nota Para obtener una lista de códigos de error válidos, vea rpc Return Values.
 

Observaciones

La función de RpcEpRegister de agrega o reemplaza entradas en la base de datos de asignación 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, dos funciones estaban disponibles para permitir que un servidor sobrescriba las entradas obsoletas de la base de datos del asignador de puntos de conexión que quedan de las 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, no se permite que los servidores reemplacen las entradas del asignador de puntos de conexión de otro servidor con fines de seguridad. Por lo tanto, RpcEpRegister y RpcEpRegisterNoReplace realizar en gran medida la misma funcionalidad.

Una aplicación de servidor llama a RpcEpRegister para registrar puntos de conexión especificados mediante una llamada a cualquiera de las funciones siguientes:

Si el servidor también exporta a la base de datos name-service, el servidor llama a RpcEpRegister con la misma IfSpec, BindingVectory valores UuidVector que se usan al llamar a la función RpcNsBindingExport.

Si se usa una secuencia de protocolo sin especificar un punto de conexión, la biblioteca en tiempo de ejecución de 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:

  • Interfaz UUID
  • Versión de interfaz (principal y secundaria)
  • Identificador de enlace
  • UUID de objeto (opcional)
  • Anotación (opcional)
RpcEpRegister crea un producto cruzado a partir del IfSpec, BindingVectory parámetros UuidVector y agrega cada elemento del producto cruzado como un registro independiente en la base de datos de mapa de puntos de conexión.

Nota

El encabezado rpcdce.h define RpcEpRegister como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito Valor
cliente mínimo admitido Windows 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
encabezado de rpcdce.h (include Rpc.h)
biblioteca de Rpcrt4.lib
DLL de Rpcrt4.dll

Consulte también

rpcBindingFromStringBinding

rpcEpRegisterNoReplace

rpcEpUnregister

RpcNsBindingExport

rpcServerInqBindings

RpcServerUseAllProtseqs

RpcServerUseAllProtseqsIf

RpcServerUseProtseq

RpcServerUseProtseqEp

RpcServerUseProtseqIf

  • Last updated on