Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All
Expand Minimize

WlxQueryTerminalServicesData function

[The WlxQueryTerminalServicesData function is no longer available for use as of Windows Server 2008 and Windows Vista.]

Called by GINA to retrieve Terminal Services user configuration information after a user has logged on.

Note   GINA DLLs are ignored in Windows Vista.

Syntax


DWORD WlxQueryTerminalServicesData(
  _In_  HANDLE                      hWlx,
  _Out_ PWLX_TERMINAL_SERVICES_DATA pTSData,
  _In_  WCHAR                       *UserName,
  _In_  WCHAR                       *Domain
);

Parameters

hWlx [in]

Specifies the Winlogon handle passed to GINA in the WlxInitialize call.

pTSData [out]

Points to a structure that will contain the user configuration information specific to Terminal Services.

UserName [in]

Pointer to a null-terminated wide character string that specifies the name of the newly logged-on user.

Domain [in]

Pointer to a null-terminated wide character string that specifies the newly logged-on user's domain.

Return value

The WlxQueryTerminalServicesData function returns zero if the user-configuration information was retrieved successfully. Otherwise, it returns an error code.

Remarks

WlxQueryTerminalServicesData should be called from within GINA's implementation of WlxLoggedOutSAS after a user has been authenticated.

In order to access this function, the GINA DLL must use the WLX_DISPATCH_VERSION_1_3 structure, and set the Winlogon version to at least WLX_VERSION_1_3 in its WlxNegotiate call.

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

End of client support

Windows XP

End of server support

Windows Server 2003

Header

Winwlx.h

See also

WlxDisconnect
WLX_DISPATCH_VERSION_1_3
WlxLoggedOutSAS
WlxNegotiate
WlxQueryClientCredentials
WlxWin31Migrate

 

 

Community Additions

ADD
Show:
© 2015 Microsoft