Метод ICredentialProvider::SetSerialization (credentialprovider.h)

Задает характеристики сериализации поставщика учетных данных.

Синтаксис

HRESULT SetSerialization(
  [in] const CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION *pcpcs
);

Параметры

[in] pcpcs

Тип: const CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION*

Указатель на структуру CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION , в которой хранятся характеристики сериализации поставщика учетных данных.

Возвращаемое значение

Тип: HRESULT

Если этот метод выполнен успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Замечания

Этот метод является обязательным. Он принимает учетные данные и определяет, является ли pcpcs частичным или полным учетным данным. Если это частичные учетные данные, оно либо является неполным, либо передано для отображения некоторых сведений пользователю. Если это полные учетные данные, его следует сериализовать и отправить. Используйте элементы CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION и флаги, переданные в SetUsageScenario , чтобы определить, как обрабатывать входные данные. Ответственность лежит на поставщике учетных данных для проверки целостности входных данных. Пользовательский интерфейс учетных данных и пользовательский интерфейс входа не выполняют никаких проверок структуры перед передачей в поставщик учетных данных.

SetSerialization всегда вызывается после SetUsageScenario. Пользовательский интерфейс входа также вызывает SetSerialization , когда фильтр возвращает учетные данные через UpdateRemoteCredential. Этот метод не используется при повторном перечислении плиток из-за вызова CredentialsChanged. Пользовательский интерфейс учетных данных вызывает SetSerialization , когда входные учетные данные были предоставлены приложением.

Пользовательский интерфейс учетных данных применяет следующие правила на основе dwFlags для этого экземпляра поставщика контента, определенного при вызове SetUsageScenario .

• Если флаги включают CREDUIWIN_IN_CRED_ONLY, все поставщики учетных данных, возвращающие S_OK , включены.
• Если флаги включают CREDUIWIN_AUTHPACKAGE_ONLY, все поставщики учетных данных, возвращающие состояние успешности, включены.
• Если ни один из этих флагов не включен, пользовательский интерфейс учетных данных следует той же логике, что и пользовательский интерфейс входа и все поставщики учетных данных, реализующие CREDENTIAL_PROVIDER_USAGE_SCENARIO CPUS_REDUI, будут включены независимо от возвращаемого значения состояния.

Требования