PWLX_QUERY_CLIENT_CREDENTIALS función de devolución de llamada (winwlx.h)
[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.
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 |
|---|---|
|
La información de credenciales se recuperó y devolvió en pCred. |
|
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 |