Función RpcBindingReset (rpcdce.h)

La función RpcBindingReset restablece un identificador de enlace para que se especifique el host, pero el servidor de ese host no está especificado.

Sintaxis

RPC_STATUS RpcBindingReset(
  RPC_BINDING_HANDLE Binding
);

Parámetros

Binding

Identificador de enlace de servidor que se va a restablecer.

Valor devuelto

Valor	Significado
RPC_S_OK	La llamada se realizó correctamente.
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.

 

Comentarios

Un cliente llama a la función RpcBindingReset para desasociar una instancia de servidor determinada del identificador de enlace de servidor especificado en el parámetro Binding . La función RpcBindingReset desasocia una instancia de servidor quitando la parte del punto de conexión de la dirección del servidor en el identificador de enlace. El host permanece sin cambios en el identificador de enlace. El resultado es un identificador de enlace de servidor parcialmente enlazado.

RpcBindingReset no afecta a la información de autenticación del parámetro Binding , si hay alguna.

Si un cliente está dispuesto a atenderlo cualquier instancia de servidor compatible en el host especificado en el identificador de enlace, el cliente llama a la función RpcBindingReset antes de realizar una llamada a procedimiento remoto mediante el identificador de enlace binding . Los clientes no deben llamar a la función RpcBindingReset para los identificadores de enlace en los que se ejecutan las llamadas.

Cuando el cliente realiza la siguiente llamada a procedimiento remoto mediante el enlace de restablecimiento (enlazado parcialmente), la biblioteca en tiempo de ejecución RPC del cliente usa un punto de conexión conocido de la especificación de interfaz del cliente, si existe. De lo contrario, la biblioteca en tiempo de ejecución del cliente se comunica automáticamente con el servicio de asignación de puntos de conexión en el host remoto especificado para obtener el punto de conexión de un servidor compatible de la base de datos de mapa de puntos de conexión. Si se encuentra un servidor compatible, la biblioteca en tiempo de ejecución rpc actualiza el enlace con un nuevo punto de conexión. Si no se encuentra un servidor compatible, se produce un error en la llamada a procedimiento remoto. Para las llamadas que usan un protocolo de conexión (ncacn), el código de estado EPT_S_NOT_REGISTERED se devuelve al cliente. Para las llamadas que usan un protocolo de datagramas (ncadg), el código de estado RPC_S_COMM_FAILURE se devuelve al cliente.

Las aplicaciones de servidor deben registrar todos los identificadores de enlace llamando a RpcEpRegister y RpcEpRegisterNoReplace si el servidor quiere estar disponible para los clientes que realizan una llamada a procedimiento remoto en un identificador de enlace de restablecimiento.

Requisitos

Cliente mínimo compatible	Windows 2000 Professional [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	Windows 2000 Server [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	rpcdce.h (include Rpc.h)
Library	Rpcrt4.lib
Archivo DLL	Rpcrt4.dll

Consulte también

RpcEpRegister

RpcEpRegisterNoReplace