ICredentialProviderCredential：：GetStringValue 方法 (credentialprovider.h)

  • 项目

允许从包含文本字段的凭据检索文本。

语法

HRESULT GetStringValue(
  [in]  DWORD  dwFieldID,
  [out] LPWSTR *ppsz
);

参数

[in] dwFieldID

类型：DWORD

字段的标识符。

[out] ppsz

类型： LPWSTR*

指向内存的指针，其中包含要返回到登录 UI 或凭据 UI 的以 null 结尾的 Unicode 字符串。

返回值

类型： HRESULT

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

注解

此方法是可选的。

登录 UI 和凭据 UI 使用此方法获取字段的 pszLabel 。 此信息对于获取CPFT_LARGE_TEXT、CPFT_SMALL_TEXT、CPFT_COMMAND_LINK、CPFT_EDIT_TEXT和CPFT_PASSWORD_TEXT字段的值是必需的。

凭据提供程序最佳做法

凭据提供程序处理极其敏感的用户机密，以便完成登录和解锁请求。 最佳做法是，密码和 PIN 等机密信息应得到最谨慎的处理。 在凭据提供程序中处理机密信息的适当技术包括：
  • 始终安全地丢弃机密。 为此，请在释放用于保存任何机密的内存之前调用 SecureZeroMemory 。
  • 使用机密后立即安全地丢弃机密。
  • 如果机密未在预期时间内用于其预期用途，请安全地丢弃这些机密。

要求

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