ICredentialProviderCredential2 인터페이스(credentialprovider.h)

사용자의 SID(보안 식별자)를 검색하는 메서드를 추가하여 ICredentialProviderCredential 인터페이스를 확장합니다. 자격 증명은 해당 사용자와 연결되며 사용자의 타일 아래에 그룹화할 수 있습니다.

상속

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

메서드

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

ICredentialProviderCredential2::GetUserSid 이 자격 증명과 연결된 사용자의 SID(보안 식별자)를 검색합니다.

설명

이 클래스는 V2 자격 증명 공급자를 만드는 데 필요합니다. V2 자격 증명 공급자는 사용자에게 개인 설정된 로그온 환경을 제공합니다. 이는 자격 증명 공급자가 로그온 UI에 사용자가 사용할 수 있는 로그인 옵션을 알려 주는 경우에 발생합니다. 새 자격 증명 공급자는 V2 자격 증명 공급자여야 합니다.

ICredentialProviderCredential2 instance 만들려면 GetUserSid 함수에서 유효한 SID를 반환해야 합니다. 유효한 것은 현재 로그온 UI에 의해 열거된 사용자 중 하나에 대해 반환된 SID에 의해 정의됩니다.

사용 가능한 사용자를 가져오고 연결할 사용자를 결정하는 데 유용한 도구는 ICredentialProviderUserArray 개체입니다. 이 개체에는 열거될 사용자에 대한 정보를 얻기 위해 쿼리할 수 있는 ICredentialProviderUser 개체 목록이 포함되어 있습니다. 예를 들어 GetStringValue를 사용하여 각각 PKEY_Identity_PrimarySid 또는 PKEY_Identity_USerName 전달된 매개 변수를 사용하여 사용자의 SID 또는 사용자 이름을 얻을 수 있습니다. SetProviderFilter를 사용하여 결과를 필터링하여 사용 가능한 사용자의 하위 집합만 표시할 수도 있습니다.

ICredentialProviderUserArray를 사용하는 것은 선택 사항이지만 유효한 SID 값을 만드는 데 필요한 정보를 가져오는 편리한 방법입니다. 로그온 UI에서 열거할 사용자 목록을 얻으려면 ICredentialProviderSetUserArray 인터페이스를 구현하여 SetUserArray에서 ICredentialProviderUserArray 개체를 가져옵니다. 로그온 UI는 GetCredentialCount 전에 SetUserArray를 호출하므로 자격 증명 공급자가 자격 증명을 반환하려고 할 때 ICredentialProviderUserArray 개체가 준비됩니다.

V2 자격 증명 공급자는 "로그인 옵션" 링크 아래에 표시되는 아이콘으로 표시됩니다. 자격 증명 공급자에 대한 아이콘을 제공하려면 자격 증명 자체에서 CPFT_TILE_IMAGE CREDENTIAL_PROVIDER_FIELD_TYPE 정의 합니다. 그런 다음 CREDENTIAL_PROVIDER_FIELD_DESCRIPTORguidFieldType이 CPFG_CREDENTIAL_PROVIDER_LOGO 설정되었는지 확인합니다. 아이콘의 권장 크기는 72x72픽셀입니다.

자격 증명 공급자에 대한 아이콘을 지정하는 것과 마찬가지로 텍스트 문자열을 지정하여 자격 증명 공급자를 식별할 수도 있습니다. 이 문자열은 사용자가 아이콘을 가리키면 팝업 창에 나타납니다. 이렇게 하려면 자격 증명 자체에서 CPFT_SMALL_TEXTCREDENTIAL_PROVIDER_FIELD_TYPE 정의합니다. 그런 다음 CREDENTIAL_PROVIDER_FIELD_DESCRIPTORguidFieldType이 CPFG_CREDENTIAL_PROVIDER_LABEL 설정되었는지 확인합니다. 이 문자열은 위에서 설명한 자격 증명 공급자 아이콘을 보완하고 사용자가 내용을 이해할 수 있을 만큼 충분히 설명해야 합니다. 예를 들어 그림 암호 공급자의 설명은 "그림 암호"입니다.

구현 시기

이 인터페이스를 구현하여 로그온 UI의 특정 사용자 타일과 자격 증명 타일을 연결합니다.

요구 사항

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

추가 정보

Windows 10 자격 증명 공급자

ICredentialProviderCredential

ICredentialProviderCredentialEvents2