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 |