Función RpcBindingInqAuthInfoExA (rpcdce.h)
La función RpcBindingInqAuthInfoEx devuelve información de autenticación, autorización y calidad de servicio de seguridad de un identificador de enlace.
Sintaxis
RPC_STATUS RpcBindingInqAuthInfoExA(
RPC_BINDING_HANDLE Binding,
RPC_CSTR *ServerPrincName,
unsigned long *AuthnLevel,
unsigned long *AuthnSvc,
RPC_AUTH_IDENTITY_HANDLE *AuthIdentity,
unsigned long *AuthzSvc,
unsigned long RpcQosVersion,
RPC_SECURITY_QOS *SecurityQOS
);
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 Binding. El contenido del nombre devuelto y su sintaxis se definen mediante el servicio de autenticación en uso.
Especifique un valor NULL para impedir que RpcBindingInqAuthInfoEx devuelva el parámetro ServerPrincName . 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 Binding. Para obtener una lista de los niveles de autenticación compatibles con RPC, consulte Constantes de nivel de autenticación. Especifique un valor NULL para impedir que la función devuelva el parámetro AuthnLevel .
El nivel devuelto en el parámetro AuthnLevel puede ser diferente del nivel especificado cuando el cliente llamó a la función RpcBindingSetAuthInfoEx . 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 Binding. Para obtener una lista de los servicios de autenticación compatibles con RPC, consulte Authentication-Service Constants(Constantes de servicio de autenticación).
Especifique un valor NULL para impedir que RpcBindingInqAuthInfoEx 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 Binding.
Especifique un valor NULL para impedir que RpcBindingInqAuthInfoEx devuelva el parámetro AuthIdentity .
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 Binding. Para obtener una lista de los servicios de autenticación compatibles con RPC, consulte Authentication-Service Constants(Constantes de servicio de autenticación).
Especifique un valor NULL para impedir que RpcBindingInqAuthInfoEx devuelva el parámetro AuthzSvc .
RpcQosVersion
Pasa el valor de la versión actual (necesario para la compatibilidad directa si se realizan extensiones a esta función). Establezca siempre este parámetro en RPC_C_SECURITY_QOS_VERSION.
SecurityQOS
Devuelve el puntero a la estructura RPC_SECURITY_QOS , que define la configuración de calidad del servicio.
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. |
|
El enlace no tiene información de autenticación. |
Comentarios
Una aplicación cliente llama a la función RpcBindingInqAuthInfoEx para ver la información de autenticación y autorización asociada a un identificador de enlace de servidor. Esta función proporciona la capacidad de consultar la calidad de seguridad del servicio en el identificador de enlace. De lo contrario, es idéntico a RpcBindingInqAuthInfo.
La biblioteca en tiempo de ejecución rpc asigna memoria para el parámetro ServerPrincName devuelto. La aplicación es responsable de llamar a la función RpcStringFree para esa cadena de argumento devuelta.
Nota:
El encabezado rpcdce.h define RpcBindingInqAuthInfoEx 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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.
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 |