ICredentialProviderCredential::GetSubmitButtonValue 方法 (credentialprovider.h)

检索字段的标识符,提交按钮应放置在登录 UI 中的 旁边。 凭据 UI 不调用此方法。

语法

HRESULT GetSubmitButtonValue(
  [in]  DWORD dwFieldID,
  [out] DWORD *pdwAdjacentTo
);

参数

[in] dwFieldID

类型:DWORD

需要提交按钮值的字段的标识符。

[out] pdwAdjacentTo

类型: DWORD*

指向一个值的指针,该值接收提交按钮应放在其旁边的字段的字段 ID。

实现者注意: 不要返回此参数中位图的字段 ID。 将提交按钮放在位图旁边是不好的 UI 设计,这样做可能会导致登录 UI 失败。

返回值

类型: HRESULT

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

备注

提交按钮未标记为这样;这只是引用单击以提交凭据的按钮的通用方法。 该按钮通常显示为包含指向右侧的箭头的圆形按钮,尽管此外观在以后的版本中可能会更改。 有关详细信息,请参阅 CPFT_SUBMIT_BUTTON

除非凭据提供程序始终执行自动提交,否则不应隐藏提交按钮。 否则,用户可能会感到困惑,因为他们看不到提交其凭据的方法。

在组装登录 UI 时调用此方法。 有关示例用法,请参阅 Windows 软件开发工具包 (SDK) 中包含的凭据提供程序示例。

.

要求

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