ICredentialProvider：：SetSerialization 方法（credentialprovider.h）

设置凭据提供程序的序列化特征。

Syntax

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 是部分凭据还是完整凭据。 如果它是部分凭据，则它不完整或已传递，目的是向用户显示一些信息。 如果是完整凭据，则应对其进行序列化和提交。 使用 SetUsageScenario 中传递的CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION和标志的成员来确定如何处理输入。 凭据提供程序负责验证输入的完整性。 凭据 UI 和登录 UI 在将结构传递给凭据提供程序之前不会对结构执行任何检查。

SetUsageScenario 之后始终调用 SetSerialization。 当筛选器通过 UpdateRemoteCredential 返回凭据时，登录 UI 还会调用 SetSerial 化。 由于对 CredentialsChanged 的调用，重新枚举磁贴时，此方法不使用此方法。 凭据 UI 在应用程序提供输入凭据时调用 SetSerialization 。

凭据 UI 根据调用 SetUsageScenario 时定义的此内容提供程序实例的 dwFlags 强制执行以下规则。

• 如果标志包括 CREDUIWIN_IN_CRED_ONLY，则启用返回 S_OK 的所有凭据提供程序。
• 如果标志包括 CREDUIWIN_AUTHPACKAGE_ONLY，则启用返回成功状态的所有凭据提供程序。
• 如果其中两个标志均未包含，则凭据 UI 遵循与登录 UI 相同的逻辑，并且将启用实现CREDENTIAL_PROVIDER_USAGE_SCENARIO CPUS_REDUI的所有凭据提供程序，而不考虑返回的状态值。

要求