PWLX_QUERY_IC_CREDENTIALS función de devolución de llamada (winwlx.h)
[La función WlxQueryInetConnectorCredentials ya no está disponible para su uso a partir de Windows Server 2008 y Windows Vista.]
Llamado por un archivo DLL de GINA de reemplazo si Terminal Services está habilitado. GINA llama a esta función para determinar si el servidor de terminal está usando licencias del conector de Internet y para recuperar la información de credenciales .
Sintaxis
PWLX_QUERY_IC_CREDENTIALS PwlxQueryIcCredentials;
BOOL PwlxQueryIcCredentials(
[out] PWLX_CLIENT_CREDENTIALS_INFO_V1_0 pCred
)
{...}
Parámetros
[out] pCred
Cuando el valor devuelto es TRUE, pCred especifica un puntero a una estructura de WLX_CLIENT_CREDENTIALS_INFO_V1_0 que contiene las credenciales que se usarán para el inicio de sesión automático.
Valor devuelto
La función WlxQueryInetConnectorCredentials devuelve uno de los valores siguientes.
| Código devuelto | Descripción |
|---|---|
|
La licencia del conector de Internet está habilitada. |
|
Las licencias de conectores de Internet no están disponibles. |
Observaciones
El archivo DLL de GINA es responsable de llamar a LocalFree para liberar los recursos utilizados 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 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 Terminal Services no usa una licencia de conector de Internet, el archivo DLL de GINA debe llamar a WlxQueryClientCredentials.
Otras funciones compatibles con Winlogon que se pueden llamar cuando Terminal Services está habilitado son WlxDisconnect, WlxQueryClientCredentials, WlxQueryTerminalServicesData y WlxWin31Migrate.
Requisitos
| 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 |