Función RpcBindingInqAuthInfoW (rpcdce.h)

Artículo
11/20/2024

La función RpcBindingInqAuthInfo devuelve información de autenticación y autorización de un identificador de enlace.

Sintaxis

RPC_STATUS RpcBindingInqAuthInfoW(
  RPC_BINDING_HANDLE       Binding,
  RPC_WSTR                 *ServerPrincName,
  unsigned long            *AuthnLevel,
  unsigned long            *AuthnSvc,
  RPC_AUTH_IDENTITY_HANDLE *AuthIdentity,
  unsigned long            *AuthzSvc
);

Parámetros

Binding

Identificador de enlace de servidor desde el que se devuelve la información de autenticación y autorización.

ServerPrincName

Devuelve un puntero a un puntero al nombre principal esperado del servidor al que se hace referencia en Enlace. El contenido del nombre devuelto y su sintaxis se definen mediante el servicio de autenticación en uso.

Especifique un valor NULL para evitar que rpcBindingInqAuthInfo devuelva el parámetro ServerPrincName de . En este caso, la aplicación no llama a la función RpcStringFree.

AuthnLevel

Devuelve un puntero establecido en el nivel de autenticación usado para las llamadas a procedimientos remotos realizadas mediante Enlace. Consulte Nota.

Especifique un valor NULL para evitar que la función devuelva el parámetro de AuthnLevel.

El nivel devuelto en el parámetro AuthnLevel de puede ser diferente del nivel especificado cuando el cliente llamó a la función rpcBindingSetAuthInfo . Esta discrepancia se produce cuando la biblioteca en tiempo de ejecución rpc no admite el nivel de autenticación especificado por el cliente y actualiza automáticamente al siguiente nivel de autenticación superior.

AuthnSvc

Devuelve un puntero establecido en el servicio de autenticación especificado para las llamadas a procedimientos remotos realizadas mediante Enlace. Consulte Nota.

Especifique un valor NULL para evitar que rpcBindingInqAuthInfo devuelva el parámetro AuthnSvc.

AuthIdentity

Devuelve un puntero a un identificador de la estructura de datos que contiene las credenciales de autenticación y autorización del cliente especificadas para las llamadas a procedimientos remotos realizadas mediante Enlace.

Especifique un valor NULL para evitar que rpcBindingInqAuthInfo devuelva el parámetro AuthIdentity de .

AuthzSvc

Devuelve un puntero establecido en el servicio de autorización solicitado por la aplicación cliente que realizó la llamada a procedimiento remoto en Enlace Ver nota.

Especifique un valor NULL para evitar que rpcBindingInqAuthInfo devuelva el parámetro authzSvc de .

Nota Para obtener una lista de los servicios de autenticación compatibles con RPC, consulte Authentication-Service Constantes.

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.
RPC_BINDING_HAS_NO_AUTH	El enlace no tiene información de autenticación.

Nota Para obtener una lista de códigos de error válidos, vea rpc Return Values.

Observaciones

Una aplicación cliente llama a la función de RpcBindingInqAuthInfo para ver la información de autenticación y autorización asociada a un identificador de enlace de servidor. Una función similar, RpcBindingInqAuthInfoEx proporciona además información de calidad de servicio de seguridad en el identificador de enlace.

La biblioteca en tiempo de ejecución de RPC asigna memoria para el parámetro ServerPrincName devuelto. La aplicación es responsable de llamar a la función de RpcStringFree para esa cadena de argumento devuelta.

Nota

El encabezado rpcdce.h define RpcBindingInqAuthInfo 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 [aplicaciones de escritorio \| Aplicaciones para UWP]
servidor mínimo admitido	Windows 2000 Server [aplicaciones de escritorio \| Aplicaciones para UWP]
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

rpcBindingInqAuthClient

RpcBindingInqAuthInfoEx

RpcBindingInqOption

RpcBindingSetAuthInfo

RpcStringFree

Compartir a través de