다음을 통해 공유


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, WlxQueryTerminalServicesDataWlxWin31Migrate입니다.

요구 사항

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

참고 항목

WLX_DISPATCH_VERSION_1_3

WlxDisconnect

WlxNegotiate

WlxQueryClientCredentials

WlxWin31Migrate