ICredentialProvider 인터페이스(credentialprovider.h)

자격 증명 공급자의 설정 및 조작에 사용되는 메서드를 노출합니다. 모든 자격 증명 공급자는 이 인터페이스를 구현해야 합니다.

상속

ICredentialProvider 인터페이스는 IUnknown 인터페이스에서 상속됩니다. ICredentialProvider 에는 다음과 같은 유형의 멤버도 있습니다.

메서드

ICredentialProvider 인터페이스에는 이러한 메서드가 있습니다.

 
ICredentialProvider::Advise

자격 증명 공급자가 콜백 인터페이스를 통해 로그온 UI 또는 자격 증명 UI에서 이벤트를 시작할 수 있습니다.
ICredentialProvider::GetCredentialAt

특정 자격 증명을 가져옵니다.
ICredentialProvider::GetCredentialCount

이 자격 증명 공급자에서 사용 가능한 자격 증명 수를 가져옵니다.
ICredentialProvider::GetFieldDescriptorAt

지정된 필드를 설명하는 메타데이터를 가져옵니다.
ICredentialProvider::GetFieldDescriptorCount

이 공급자의 자격 증명을 표시하는 데 필요한 의 필드 수를 검색합니다.
ICredentialProvider::SetSerialization

자격 증명 공급자의 serialization 특성을 설정합니다.
ICredentialProvider::SetUsageScenario

자격 증명 공급자가 유효한 시나리오를 정의합니다. 자격 증명 공급자가 초기화될 때마다 호출됩니다.
ICredentialProvider::UnAdvise

로그온 UI 또는 자격 증명 UI에서 이벤트 콜백이 더 이상 허용되지 않는다는 것을 자격 증명 공급자에게 조언하는 데 사용됩니다.

설명

이 인터페이스는 앱에 대한 로그온 UI 및 자격 증명 UI와 상호 작용하는 방법입니다.

인스턴스화된 자격 증명 공급자는 로그온 UI의 전체 수명 동안 유지 관리됩니다. 이 때문에 로그온 UI는 자격 증명 공급자의 상태를 유지할 수 있습니다. 특히 자격 증명을 제공한 공급자와 타일을 기억합니다. 즉, CPUS_LOGON, CPUS_UNLOCK_WORKSTATION CPUS_CHANGE_PASSWORD CREDENTIAL_PROVIDER_USAGE_SCENARIO 사용할 때 상태 정보를 저장할 수 있습니다. 자격 증명 UI의 경우는 그렇지 않습니다. 자격 증명 UI는 애플리케이션이 CredUIPromptForWindowsCredentials를 호출할 때마다 공급자의 새 instance 만듭니다. 이 때문에 자격 증명 UI는 자격 증명 공급자의 상태를 기억할 수 없습니다.

한 시나리오에서 생성된 CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION 저장되어 후속 사용 시나리오에서 사용될 수 있습니다. 이 때문에 ICredentialProvider 구현이 이 시나리오를 처리할 수 있을 만큼 강력한지 확인해야 합니다.

Windows 8은 자격 증명 공급자 API에 새로운 기능을 추가하며, 주로 사용자별로 자격 증명을 그룹화할 수 있습니다.

요구 사항

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

추가 정보

CREDENTIAL_PROVIDER_USAGE_SCENARIO

자격 증명 공급자 기반 Windows 로그온 환경

Windows 10 자격 증명 공급자

ICredentialProviderCredential