Función RpcBindingSetAuthInfoExA (rpcdce.h)
La función RpcBindingSetAuthInfoEx establece la información de autenticación, autorización y calidad de servicio de un controlador de enlace.
RPC_STATUS RpcBindingSetAuthInfoExA(
RPC_BINDING_HANDLE Binding,
RPC_CSTR ServerPrincName,
unsigned long AuthnLevel,
unsigned long AuthnSvc,
RPC_AUTH_IDENTITY_HANDLE AuthIdentity,
unsigned long AuthzSvc,
RPC_SECURITY_QOS *SecurityQos
);
Binding
Identificador de enlace de servidor en el que se establece la información de autenticación y autorización.
ServerPrincName
Puntero al nombre principal esperado del servidor al que hace referencia enlace. El contenido del nombre y su sintaxis se definen mediante el servicio de autenticación en uso.
AuthnLevel
Nivel de autenticación que se realizará en las llamadas a procedimientos remotos realizadas mediante Enlace. Para obtener una lista de los niveles de autenticación compatibles con RPC, consulte Authentication-Level Constantes.
AuthnSvc
Servicio de autenticación que se va a usar.
Especifique RPC_C_AUTHN_NONE para desactivar la autenticación de las llamadas a procedimientos remotos realizadas mediante Enlace.
Si se especifica RPC_C_AUTHN_DEFAULT, la biblioteca en tiempo de ejecución rpc usa el servicio de autenticación de RPC_C_AUTHN_WINNT para las llamadas a procedimientos remotos realizadas mediante Enlace.
AuthIdentity
Identificador de la estructura que contiene las credenciales de autenticación y autorización del cliente adecuadas para el servicio de autenticación y autorización seleccionados.
Al usar el servicio de autenticación de RPC_C_AUTHN_WINNTAuthIdentity debe ser un puntero a una estructura de SEC_WINNT_AUTH_IDENTITY (definida en Rpcdce.h). Los servicios de autenticación Kerberos y Negotiate también usan la estructura de SEC_WINNT_AUTH_IDENTITY.
Especifique un valor NULL para usar el contexto de inicio de sesión de seguridad para el espacio de direcciones actual. Pase el valor RPC_C_NO_CREDENTIALS para usar un contexto de inicio de sesión anónimo. Tenga en cuenta que RPC_C_NO_CREDENTIALS solo es válido si RPC_C_AUTHN_GSS_SCHANNEL está seleccionado como servicio de autenticación.
AuthzSvc
Servicio de autorización implementado por el servidor para la interfaz de interés. La validez y confiabilidad de los datos de autorización, como cualquier dato de aplicación, depende del servicio de autenticación y del nivel de autenticación seleccionado. Este parámetro se omite al usar el servicio de autenticación RPC_C_AUTHN_WINNT. Consulte Nota.
SecurityQos
Puntero a la estructura RPC_SECURITY_QOS, que define la calidad de servicio de seguridad.
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. |
|
Servicio de autenticación desconocido. |
Una aplicación cliente llama a la función RpcBindingSetAuthInfoEx para configurar un identificador de enlace de servidor para realizar llamadas a procedimientos remotos autenticados. Esta función proporciona la capacidad de establecer información de calidad de servicio de seguridad en el identificador de enlace. De lo contrario, es idéntico a RpcBindingSetAuthInfo.
A menos que un cliente llame a RpcBindingSetAuthInfoEx, todas las llamadas a procedimientos remotos en Enlace no están autenticadas. No es necesario que un cliente llame a esta función.
La función
Nota
El encabezado rpcdce.h define RpcBindingSetAuthInfoEx 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.
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 |