ICredentialProviderCredential::SetStringValue 方法 (credentialprovider.h)

启用登录 UI 或凭据 UI 以在用户键入 时更新CPFT_EDIT_TEXT 字段的文本。

语法

HRESULT SetStringValue(
  [in] DWORD   dwFieldID,
  [in] LPCWSTR psz
);

参数

[in] dwFieldID

类型:DWORD

需要更新的字段的标识符。

[in] psz

类型: LPCWSTR

指向包含新文本的缓冲区的指针。

返回值

类型: HRESULT

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

注解

此方法是可选的。

凭据提供程序最佳做法

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

要求

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