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.
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 |
|
See also
- WlxDisconnect
- WLX_DISPATCH_VERSION_1_3
- WlxLoggedOutSAS
- WlxNegotiate
- WlxQueryClientCredentials
- WlxWin31Migrate