Función RpcEpResolveBinding (rpcdce.h)

Artículo
08/25/2023

La función RpcEpResolveBinding resuelve un identificador de enlace de servidor enlazado parcialmente en un identificador de enlace de servidor totalmente enlazado.

Sintaxis

RPC_STATUS RpcEpResolveBinding(
  RPC_BINDING_HANDLE Binding,
  RPC_IF_HANDLE      IfSpec
);

Parámetros

Binding

Identificador de enlace de servidor enlazado parcialmente para resolverlo en un identificador de enlace de servidor totalmente enlazado.

IfSpec

Estructura generada por código auxiliar que especifica la interfaz de interés.

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

Una aplicación llama a la función RpcEpResolveBinding para resolver un identificador de enlace de servidor enlazado parcialmente en un identificador de enlace totalmente enlazado.

La resolución de identificadores de enlace requiere un UUID de interfaz y un UUID de objeto (que puede ser nulo). La biblioteca en tiempo de ejecución rpc solicita al servicio de asignación de puntos de conexión en el host especificado por el parámetro Binding que busque un punto de conexión para una instancia de servidor compatible. Para buscar el punto de conexión, el servicio de asignación de puntos de conexión busca el UUID de interfaz en el parámetro IfSpec y el UUID del objeto en el parámetro Binding , si existe.

La forma en que las funciones de la operación de enlace de resolución dependen de si el identificador de enlace especificado está enlazado parcialmente o totalmente. Cuando el cliente especifica un identificador enlazado parcialmente, la operación de enlace de resolución tiene los siguientes resultados posibles:

Si no se registran instancias de servidor compatibles en la base de datos de asignación de puntos de conexión, la operación resolve-binding devuelve el código de estado EPT_S_NOT_REGISTERED.
Si se registra una instancia de servidor compatible en la base de datos de mapa de puntos de conexión, la operación resolve-binding devuelve un enlace totalmente enlazado y el código de estado RPC_S_OK.

Cuando el cliente especifica un identificador de enlace totalmente enlazado, la operación resolve-binding devuelve el identificador de enlace especificado y el código de estado RPC_S_OK. La operación resolve-binding no se comunica con el servicio de asignación de puntos de conexión.

En ninguna de las mayúsculas y minúsculas de enlace parcialmente ni enlazadas por completo, la operación de enlace de resolución se comunica con una instancia de servidor compatible.

Nota Llamar a RpcEpResolveBinding no es estrictamente necesario. Si se realiza una llamada RPC en un identificador de enlace de servidor enlazado parcialmente, el tiempo de ejecución de RPC lleva los pasos necesarios para convertir el enlace en un identificador de enlace totalmente enlazado. El tiempo de ejecución de RPC llama a RpcEpResolveBinding, pero lo hace de forma más eficaz debido a técnicas de almacenamiento en caché adicionales. En Windows XP y Windows 2000, las aplicaciones no tienen ninguna razón para llamar a RpcEpResolveBinding.

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