PWLX_QUERY_TERMINAL_SERVICES_DATA 콜백 함수(winwlx.h)

아티클
03/04/2024

[WlxQueryTerminalServicesData 함수는 Windows Server 2008 및 Windows Vista를 기준으로 더 이상 사용할 수 없습니다.]

사용자가 로그온한 후 터미널 서비스 사용자 구성 정보를 검색하기 위해 GINA 에서 호출됩니다.

참고 GINA DLL은 Windows Vista에서 무시됩니다.

구문

PWLX_QUERY_TERMINAL_SERVICES_DATA PwlxQueryTerminalServicesData;

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

매개 변수

[in] hWlx

WlxInitialize 호출에서 GINA에 전달된 Winlogon 핸들을 지정합니다.

[out] pTSData

터미널 서비스와 관련된 사용자 구성 정보를 포함할 구조를 가리킵니다.

[in] UserName

새로 로그온한 사용자의 이름을 지정하는 null로 끝나는 와이드 문자열에 대한 포인터입니다.

[in] Domain

새로 로그온한 사용자의 도메인을 지정하는 null로 끝나는 와이드 문자열에 대한 포인터입니다.

반환 값

사용자 구성 정보가 성공적으로 검색되면 WlxQueryTerminalServicesData 함수는 0을 반환합니다. 그렇지 않으면 오류 코드를 반환합니다.

설명

WlxQueryTerminalServicesData 는 사용자가 인증된 후 GINA의 WlxLoggedOutSAS 구현 내에서 호출되어야 합니다.

이 함수에 액세스하려면 GINA DLL이 WLX_DISPATCH_VERSION_1_3 구조를 사용하고 Winlogon 버전을 WlxNegotiate 호출에서 WLX_VERSION_1_3 이상으로 설정해야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	winwlx.h