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.

Sintaxis

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
);

Parámetros

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.

Nota Para el conjunto de nombres de destino permitidos para SSP, consulte los comentarios de la documentación de InitializeSecurityContext.

 

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.

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_S_UNKNOWN_AUTHN_SERVICE	Servicio de autenticación desconocido.

 

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 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 RpcBindingSetAuthInfoEx toma una instantánea de las credenciales. Por lo tanto, se puede liberar la memoria dedicada al parámetro AuthIdentity antes de que el identificador de enlace. La excepción a esto es cuando la aplicación usa rpcBindingSetAuthInfoEx con RPC_C_QOS_IDENTITY_DYNAMIC y también especifica un valor de NULL nopara AuthIdentity.

Nota La función RpcBindingSetAuthInfo no debe llamarse en un identificador de enlace mientras una llamada RPC en el mismo identificador está en curso. Si lo hace, se generan resultados indefinidos.

 

Debido a los distintos requisitos de diferentes versiones de RPC de Microsoft, Microsoft recomienda que una aplicación mantenga un puntero al parámetro AuthIdentity siempre que exista el identificador de enlace. Si lo hace, aumenta la portabilidad de las aplicaciones.

Windows Server 2003 con SP1 y Windows XP con SP2: Para Windows XP SP2 y Windows Server 2003 SP1, no es necesario mantener el puntero al parámetro de AuthIdentity durante la vida útil del identificador de enlace. Este puntero solo se debe mantener si se realizan llamadas posteriores a RpcBindingInqAuthInfo o se realizan RpcBindingInqAuthInfoEx.

Nota La secuencia de protocolo ncalrpc admite solo RPC_C_AUTHN_WINNT, pero admite la autenticación mutua; proporcione un SPN y solicite autenticación mutua a través del parámetro SecurityQOS para lograrlo.

 

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.

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

RPC_SECURITY_QOS

RpcBindingInqAuthInfoEx

RpcServerRegisterAuthInfo