PWLX_QUERY_CLIENT_CREDENTIALS función de devolución de llamada (winwlx.h)

  • Artículo

[La función WlxQueryClientCredentials ya no está disponible para su uso a partir de Windows Server 2008 y Windows Vista.]

Una DLL de GINA de reemplazo llama a la función WlxQueryClientCredentials si Terminal Services está habilitado.

Nota Los archivos DLL de GINA se omiten en Windows Vista.
 
GINA llama a esta función para recuperar las credenciales de los clientes remotos de Terminal Services que no usan una licencia de conector de Internet.

El archivo DLL de GINA puede usar esta información para rellenar automáticamente un cuadro de inicio de sesión e intentar registrar al usuario.

Sintaxis

PWLX_QUERY_CLIENT_CREDENTIALS PwlxQueryClientCredentials;

BOOL PwlxQueryClientCredentials(
  [out] PWLX_CLIENT_CREDENTIALS_INFO_V1_0 pCred
)
{...}

Parámetros

[out] pCred

Especifica un puntero a una estructura WLX_CLIENT_CREDENTIALS_INFO_V1_0 que contiene las credenciales del cliente al devolver.

Valor devuelto

La función WlxQueryClientCredentials devuelve uno de los siguientes valores.

Código devuelto Descripción
TRUE
 La información de credenciales se recuperó y devolvió en pCred.
FALSE
 No se recuperó la información de credenciales.

Comentarios

El archivo DLL de GINA es responsable de llamar a LocalFree para liberar los recursos usados por esta estructura cuando la estructura ya no es necesaria.

Para acceder a esta función, el archivo DLL de GINA debe usar la estructura de WLX_DISPATCH_VERSION_1_3 y establecer la versión de Winlogon en al menos WLX_VERSION_1_3 en su llamada a WlxNegotiate .

Si el cliente de Terminal Services usa una licencia de conector de Internet, el archivo DLL de GINA debe llamar a WlxQueryInetConnectorCredentials.

Otras funciones de compatibilidad con Winlogon que se pueden llamar cuando Terminal Services está habilitado son WlxDisconnect, WlxQueryInetConnectorCredentials y WlxWin31Migrate.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado winwlx.h

Consulte también

WLX_DISPATCH_VERSION_1_3

WlxDisconnect

WlxNegotiate

WlxQueryInetConnectorCredentials

WlxWin31Migrate