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

Artículo
03/04/2024

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

Lo llama GINA para recuperar la información de configuración del usuario de Terminal Services después de que un usuario haya iniciado sesión.

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

Sintaxis

PWLX_QUERY_TERMINAL_SERVICES_DATA PwlxQueryTerminalServicesData;

DWORD PwlxQueryTerminalServicesData(
  [in]  HANDLE hWlx,
  [out] PWLX_TERMINAL_SERVICES_DATA pTSData,
  [in]  WCHAR *UserName,
  [in]  WCHAR *Domain
)
{...}

Parámetros

[in] hWlx

Especifica el identificador de Winlogon pasado a GINA en la llamada a WlxInitialize .

[out] pTSData

Apunta a una estructura que contendrá la información de configuración del usuario específica de Terminal Services.

[in] UserName

Puntero a una cadena de caracteres anchos terminada en NULL que especifica el nombre del usuario que acaba de iniciar sesión.

[in] Domain

Puntero a una cadena de caracteres anchos terminada en NULL que especifica el dominio del usuario que acaba de iniciar sesión.

Valor devuelto

La función WlxQueryTerminalServicesData devuelve cero si la información de configuración del usuario se recuperó correctamente. De lo contrario, devuelve un código de error.

Comentarios

Se debe llamar a WlxQueryTerminalServicesData desde la implementación de GINA de WlxLoggedOutSAS después de que se haya autenticado un usuario.

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 .

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