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

Artículo
08/28/2023

[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 .

Nota Los archivos DLL de GINA se omiten en Windows Vista.

Después, 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_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
TRUE	La licencia del conector de Internet está habilitada.
FALSE	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