ICredentialProvider：：SetUsageScenario 方法 (credentialprovider.h)

项目
08/22/2023

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

语法

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

通过