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 |