Función SaferAPIGetTrustedSignonWithEnv

Para que Access Manager pueda autenticar correctamente a los usuarios, los inicios de sesión del SO deben existir y estar habilitados en el espacio de nombres actual.

La memoria de los valores trustedSignonName y trustedDomainName devueltos se asigna de manera interna en esta API. Si la función devuelve SAFER_SUCCESS, Access Manager llama a SaferAPIFreeTrustedSignon para liberar la memoria asignada.

La memoria del valor reqEnvVarList devuelto se asigna de manera interna en esta API. Si la función devuelve SAFER_INFO_REQUIRED, Access Manager llama a SaferAPIFreeBuffer() para liberar la memoria asignada.

Debe implementar las funciones SaferAPIGetTrustedSignon y SaferAPIFreeBuffer para registrar correctamente la biblioteca cuando se implementa SaferAPIGetTrustedSignonWithEnv. La función SaferAPIGetError sólo es necesaria si desea que se devuelvan desde el conector mensajes de error específicos.

Sintaxis

SaferAPIGetTrustedSignonWithEnv(

   EnvVar             envVar[],                    /*[IN]*/

   char               **reqEnvVarList,             /*[OUT]*/

   void               **trustedSignonName,         /*[OUT]*/

   unsigned long      *trustedSignonNameLength,    /*[OUT]*/

   void               **trustedDomainName,         /*[OUT]*/

   unsigned long      *trustedDomainNameLength,    /*[OUT]*/

   SAFER_USER_TYPE    *userType,                   /*[OUT]*/

   void               **implementerData);          /*[IN/OUT]*/

Parámetros de la función SaferAPIGetTrustedSignonWithEnv

Tabla 1. Parámetros y descripción de la función SaferAPIGetTrustedSignonWithEnv
Parámetro	Descripción
[in] envVar	Matriz de los valores y nombres de variables de entorno recuperados del servidor web. El final de la matriz se representa con una entrada con un valor envVarName nulo y un valor envVarValue nulo. Tenga en cuenta que la primera vez que se llama a esta API, la matriz envVar sólo contendrá el final del marcador de la matriz.
[in] reqEnvVarList	Cadena que contiene una lista separada por comas con los nombres de variables de entorno solicitados por el módulo de inicio de sesión de confianza. El final de la lista debe terminar con un carácter nulo.
[out] trustedSignonName	Secuencia de bytes que identifica al usuario actualmente autenticado. No es necesario que este valor termine con un valor nulo. Este valor es obligatorio.
[out] trustedSignonNameLength	Valor entero que indica la longitud del valor trustedSignonName. Dicha longitud debe excluir el carácter de finalización nulo, si lo hay. Este valor es obligatorio.
[out] trustedDomainName	Secuencia de bytes que identifica el dominio del usuario actualmente autenticado. Este valor no tiene por qué ser nulo. Si no hay un valor trustedDomainName, la devolución será nula. Este valor es opcional.
[out] trustedDomainNameLength	Valor entero que indica la longitud del valor trustedDomainName. Dicha longitud debe excluir el carácter de finalización nulo, si lo hay. Este valor es obligatorio y se debe establecer en cero si no existe un valor trustedDomainName.
[out] userType	Valor que indica el tipo de usuario que autenticará Access Manager. Este valor es obligatorio. Access Manager necesita los siguientes valores de retorno para autenticar correctamente a los usuarios: SAFER_NORMAL_USER Usuario con nombre. En el espacio de nombres actual deben existir y estar habilitados los inicios de sesión del SO. SAFER_GUEST_USER Usuario invitado. En el espacio de nombres actual debe existir y estar habilitada una cuenta de usuario invitado. SAFER_ANONYMOUS_USER Usuario anónimo. En el espacio de nombres actual debe existir y estar habilitada una cuenta de usuario anónimo.
[in/out] implementerData	Puntero utilizado para conservar los datos específicos de la implementación entre llamadas. Se produce una llamada cada vez que Access Manager llama al conector de inicio de sesión de confianza. Este valor sólo es válido si se ha llamado al conector del inicio de sesión de confianza y se ha establecido un valor para él.