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:
© 2014 Microsoft