ICredentialProviderCredential 인터페이스(credentialprovider.h)
자격 증명을 처리할 수 있는 메서드를 노출합니다.
상속
ICredentialProviderCredential 인터페이스는 IUnknown 인터페이스에서 상속됩니다. ICredentialProviderCredential 에는 다음과 같은 유형의 멤버도 있습니다.
메서드
ICredentialProviderCredential 인터페이스에는 이러한 메서드가 있습니다.
| ICredentialProviderCredential::Advise 자격 증명이 콜백 인터페이스를 통해 로그온 UI 또는 자격 증명 UI에서 이벤트를 시작할 수 있도록 합니다. 이 메서드는 ICredentialProviderCredential 인터페이스의 다른 메서드 앞에 호출되어야 합니다. |
| ICredentialProviderCredential::CommandLinkClicked 로그온 UI 및 자격 증명 UI를 사용하여 링크를 클릭했음을 나타냅니다. |
| ICredentialProviderCredential::GetBitmapValue 비트맵 필드가 있는 자격 증명에서 비트맵 데이터를 검색할 수 있습니다. |
| ICredentialProviderCredential::GetCheckboxValue 확인란 값을 검색합니다. |
| ICredentialProviderCredential::GetComboBoxValueAt 지정된 인덱스에서 콤보 상자 항목의 문자열 레이블을 가져옵니다. |
| ICredentialProviderCredential::GetComboBoxValueCount 지정된 콤보 상자의 항목 수를 가져오고 초기 선택 항목이 있어야 하는 항목을 지정합니다. |
| ICredentialProviderCredential::GetFieldState 필드 상태를 검색합니다. 로그온 UI 및 자격 증명 UI는 이 정보를 사용하여 자격 증명의 필드에 대한 정보를 얻고 이 정보를 사용자 타일에 표시합니다. |
| ICredentialProviderCredential::GetSerialization 이 자격 증명을 기본 인증 엔진에 제출하려는 시도에 대한 응답으로 호출됩니다. |
| ICredentialProviderCredential::GetStringValue 텍스트 필드가 있는 자격 증명에서 텍스트를 검색할 수 있습니다. |
| ICredentialProviderCredential::GetSubmitButtonValue 제출 단추가 로그온 UI 옆에 배치되어야 하는 필드의 식별자를 검색합니다. |
| ICredentialProviderCredential::ReportResult 수신된 오류 상태 코드를 적절한 사용자가 읽을 수 있는 메시지로 변환합니다. |
| ICredentialProviderCredential::SetCheckboxValue 로그온 UI 및 자격 증명 UI를 사용하여 확인란 값이 변경되었음을 나타냅니다. |
| ICredentialProviderCredential::SetComboBoxSelectedValue 로그온 UI 및 자격 증명 UI를 사용하여 콤보 상자 값이 선택되었음을 나타냅니다. |
| ICredentialProviderCredential::SetDeselected 자격 증명이 선택 영역을 잃을 때 호출됩니다. |
| ICredentialProviderCredential::SetSelected 자격 증명을 선택할 때 호출됩니다. 구현자가 로그온 특성을 설정할 수 있도록 합니다. |
| ICredentialProviderCredential::SetStringValue 로그온 UI 또는 자격 증명 UI를 사용하여 사용자가 입력할 때 CPFT_EDIT_TEXT 필드의 텍스트를 업데이트할 수 있습니다. |
| ICredentialProviderCredential::UnAdvise 로그온 UI 또는 자격 증명 UI에서 이벤트 콜백이 더 이상 허용되지 않는다는 것을 자격 증명에 조언하는 데 사용됩니다. |
설명
구현 시기
ICredentialProviderCredential 은 사용자 자격 증명을 묻는 로그온 UI 또는 자격 증명 UI를 제공하는 외부 당사자에 의해 구현됩니다. 이 인터페이스를 구현하지 않으면 사용자 타일 열거를 수행할 수 없습니다.자격 증명 공급자 모범 사례
자격 증명 공급자는 로그온을 완료하고 요청을 잠금 해제하기 위해 매우 중요한 사용자 비밀을 처리합니다. 암호 및 PIN과 같은 비밀 정보는 최대한 주의하여 처리하는 것이 좋습니다. 자격 증명 공급자 내에서 비밀 정보를 처리하는 적절한 기술은 다음과 같습니다.- 항상 안전하게 비밀을 삭제합니다. 이렇게 하려면 비밀을 유지하는 데 사용되는 메모리를 해제하기 전에 SecureZeroMemory 를 호출합니다.
- 비밀을 사용한 후 즉시 안전하게 삭제합니다.
- 필요한 시간 내에 의도한 용도로 사용되지 않는 경우 비밀을 안전하게 삭제합니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | credentialprovider.h |