ICredentialProvider：：SetUsageScenario 方法 (credentialprovider.h)

  • 项目

定义凭据提供程序有效的方案。 每当初始化凭据提供程序时调用。

语法

HRESULT SetUsageScenario(
  [in] CREDENTIAL_PROVIDER_USAGE_SCENARIO cpus,
  [in] DWORD                              dwFlags
);

参数

[in] cpus

类型： CREDENTIAL_PROVIDER_USAGE_SCENARIO

创建凭据提供程序的方案。 这是需要支持的使用方案。 有关详细信息，请参阅备注。

[in] dwFlags

类型：DWORD

一个影响凭据提供程序行为的 值。 此值可以是 Wincred.h 中定义的以下一个或多个值的按位或组合。 有关详细信息 ，请参阅 CredUIPromptForWindowsCredentials 。

CREDUIWIN_GENERIC (0x00000001)

0x00000001。 调用方请求凭据提供程序以纯文本形式返回用户名和密码。 此值不能与 CREDUIWIN_SECURE_PROMPT 组合使用。

CREDUIWIN_CHECKBOX (0x00000002)

0x00000002。 对话框中将显示“保存检查框。

CREDUIWIN_AUTHPACKAGE_ONLY (0x00000010)

0x00000010。 应仅枚举支持输入身份验证包的凭据提供程序。 如果凭据提供程序不支持输入身份验证包，则应枚举零用户磁贴。 此值不能与 CREDUIWIN_IN_CRED_ONLY 组合使用。

CREDUIWIN_IN_CRED_ONLY (0x00000020)

0x00000020。 如果提供程序可以序列化凭据，则应枚举该凭据的磁贴。 不应枚举其他磁贴。 凭据提供程序应使用 ICredentialProvider：：SetSerialization 和 ICredentialProvider：：SetUsageScenario中的输入CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION，以确定要枚举的凭据磁贴数。 此值不能与 CREDUIWIN_AUTHPACKAGE_ONLY 组合使用。

CREDUIWIN_ENUMERATE_ADMINS (0x00000100)

0x00000100。 凭据提供程序应仅枚举管理员。 此值仅用于 UAC。 建议外部调用方不要设置此标志。

CREDUIWIN_ENUMERATE_CURRENT_USER (0x00000200)

0x00000200。 凭据提供程序应枚举当前登录用户的磁贴。

CREDUIWIN_SECURE_PROMPT (0x00001000)

0x00001000。 凭据对话框应显示在安全桌面上。 此值不能与 CREDUIWIN_GENERIC 组合使用。 凭据提供程序实现者可以安全地忽略此标志。

CREDUIWIN_PACK_32_WOW (0x10000000)

0x10000000。 传递给提供程序的缓冲区为 32 位。 从提供程序返回的缓冲区也必须是 32 位。 这是 WOW64 所必需的。

返回值

类型： HRESULT

如果该方法成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。

注解

此方法是必需的，并使凭据提供程序能够指示如何使用此方法。

如果调用完成，但不支持请求的使用方案，此方法应返回 E_NOTIMPL 。 如果方法成功且支持使用方案，则此方法应返回 S_OK 。

要求

   
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 credentialprovider.h