다음을 통해 공유


PWLX_QUERY_CLIENT_CREDENTIALS 콜백 함수(winwlx.h)

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

터미널 서비스를 사용하는 경우 대체 GINA DLL에서 WlxQueryClientCredentials 함수를 호출합니다.

참고 GINA DLL은 Windows Vista에서 무시됩니다.
 
GINA 는 이 함수를 호출하여 인터넷 커넥터 라이선스를 사용하지 않는 원격 터미널 서비스 클라이언트의 자격 증명 을 검색합니다.

GINA DLL은 이 정보를 사용하여 로그온 상자를 자동으로 입력하고 사용자를 로그인하려고 시도할 수 있습니다.

구문

PWLX_QUERY_CLIENT_CREDENTIALS PwlxQueryClientCredentials;

BOOL PwlxQueryClientCredentials(
  [out] PWLX_CLIENT_CREDENTIALS_INFO_V1_0 pCred
)
{...}

매개 변수

[out] pCred

반환할 클라이언트의 자격 증명을 포함하는 WLX_CLIENT_CREDENTIALS_INFO_V1_0 구조체에 대한 포인터를 지정합니다.

반환 값

WlxQueryClientCredentials 함수는 다음 값 중 하나를 반환합니다.

반환 코드 설명
TRUE
자격 증명 정보가 검색되어 pCred로 반환되었습니다.
FALSE
자격 증명 정보가 검색되지 않았습니다.

설명

GINA DLL은 구조가 더 이상 필요하지 않을 때 이 구조체에서 사용하는 리소스를 해제하기 위해 LocalFree 를 호출합니다.

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

터미널 서비스 클라이언트가 인터넷 커넥터 라이선스를 사용하는 경우 GINA DLL은 WlxQueryInetConnectorCredentials를 호출해야 합니다.

터미널 서비스를 사용할 때 호출될 수 있는 다른 Winlogon 지원 함수는 WlxDisconnect, WlxQueryInetConnectorCredentialsWlxWin31Migrate입니다.

요구 사항

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

추가 정보

WLX_DISPATCH_VERSION_1_3

WlxDisconnect

WlxNegotiate

WlxQueryInetConnectorCredentials

WlxWin31Migrate