Поделиться через

Метод 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, будут включены независимо от возвращаемого значения состояния.
Поставщики учетных данных, реализующие CREDENTIAL_PROVIDER_USAGE_SCENARIOCPUS_LOGON и возвращающие ошибку из этого метода, по-прежнему будут включены.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header credentialprovider.h