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, WlxQueryInetConnectorCredentials 및 WlxWin31Migrate입니다.