ICredentialProvider::SetSerialization 메서드(credentialprovider.h)
자격 증명 공급자의 serialization 특성을 설정합니다.
구문
HRESULT SetSerialization(
[in] const CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION *pcpcs
);
매개 변수
[in] pcpcs
형식: const CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION*
자격 증명 공급자의 serialization 특성을 저장하는 CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION 구조체에 대한 포인터입니다.
반환 값
형식: HRESULT
메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.
설명
이 메서드는 필수입니다. 자격 증명을 수락하고 pcpcs 가 부분 자격 증명인지 전체 자격 증명인지 확인합니다. 부분 자격 증명인 경우 일부 정보를 사용자에게 표시하기 위해 불완전하거나 전달되었습니다. 전체 자격 증명인 경우 직렬화하여 제출해야 합니다. CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION 멤버와 SetUsageScenario에 전달된 플래그를 사용하여 입력을 처리하는 방법을 결정합니다. 자격 증명 공급자는 입력의 무결성을 확인해야 합니다. 자격 증명 UI 및 로그온 UI는 자격 증명 공급자에게 전달하기 전에 구조체에 대한 검사를 수행하지 않습니다.
SetSerialization 은 항상 SetUsageScenario 다음에 호출됩니다. 또한 로그온 UI는 필터가 UpdateRemoteCredential을 통해 자격 증명을 반환할 때 SetSerialization을 호출합니다. CredentialsChanged 호출로 인해 타일을 다시 열거할 때는 이 메서드를 사용하지 않습니다. 애플리케이션에서 입력 자격 증명을 대체한 경우 자격 증명 UI는 SetSerialization 을 호출합니다.
자격 증명 UI는 SetUsageScenario가 호출될 때 정의된 instance 이 콘텐츠 공급자의 dwFlags에 따라 다음 규칙을 적용합니다.
- 플래그에 CREDUIWIN_IN_CRED_ONLY 포함된 경우 S_OK 반환하는 모든 자격 증명 공급자가 사용하도록 설정됩니다.
- 플래그에 CREDUIWIN_AUTHPACKAGE_ONLY 포함된 경우 성공 상태 반환하는 모든 자격 증명 공급자가 사용하도록 설정됩니다.
- 이러한 플래그가 모두 포함되지 않은 경우 자격 증명 UI는 로그온 UI와 동일한 논리를 따르며 CREDENTIAL_PROVIDER_USAGE_SCENARIO CPUS_REDUI 구현하는 모든 자격 증명 공급자는 반환된 상태 값에 관계없이 사용하도록 설정됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | credentialprovider.h |