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 |
|---|---|
|
La llamada se realizó correctamente. |
|
El identificador de enlace no era válido. |
|
Este era el tipo incorrecto de enlace para la operación. |
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 |