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 구현하는 모든 자격 증명 공급자는 반환된 상태 값에 관계없이 사용하도록 설정됩니다.

CPUS_LOGON CREDENTIAL_PROVIDER_USAGE_SCENARIO구현하고 이 메서드에서 오류를 반환하는 자격 증명 공급자는 계속 사용하도록 설정됩니다.

요구 사항

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