PWLX_QUERY_IC_CREDENTIALS 콜백 함수(winwlx.h)

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

터미널 서비스를 사용하는 경우 대체 GINA DLL에서 호출됩니다. GINA 는 이 함수를 호출하여 터미널 서버가 인터넷 커넥터 라이선스를 사용하고 있는지 여부를 확인하고 자격 증명 정보를 검색합니다.

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

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

구문

PWLX_QUERY_IC_CREDENTIALS PwlxQueryIcCredentials;

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

[out] pCred

반환 값이 TRUE이면 pCred 는 자동 로그온에 사용할 자격 증명이 포함된 WLX_CLIENT_CREDENTIALS_INFO_V1_0 구조체에 대한 포인터를 지정합니다.

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

반환 코드	설명
TRUE	인터넷 커넥터 라이선스가 사용하도록 설정됩니다.
FALSE	인터넷 커넥터 라이선스를 사용할 수 없습니다.

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

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

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

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