Поделиться через

Метод ICredentialProviderCredential::GetStringValue (credentialprovider.h)

  • Статья

Включает извлечение текста из учетных данных с помощью текстового поля.

Синтаксис

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

Параметры

[in] dwFieldID

Тип: DWORD

Идентификатор поля.

[out] ppsz

Тип: LPWSTR*

Указатель на память, содержащую строку Юникода, завершающуюся значением NULL, для возврата в пользовательский интерфейс входа или пользовательский интерфейс учетных данных.

Возвращаемое значение

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Этот метод является необязательным.

В пользовательском интерфейсе входа и пользовательском интерфейсе учетных данных этот метод позволяет получить pszLabel для поля. Эти сведения необходимы для получения значений для полей CPFT_LARGE_TEXT, CPFT_SMALL_TEXT, CPFT_COMMAND_LINK, CPFT_EDIT_TEXT и CPFT_PASSWORD_TEXT .

Рекомендации по поставщику учетных данных

Поставщики учетных данных обрабатывают крайне конфиденциальные секреты пользователей для выполнения запросов на вход и разблокировку. Рекомендуется с максимальной осторожностью обрабатывать секретные сведения, такие как пароли и ПИН-коды. Правильные методы обработки секретной информации в поставщике учетных данных:
  • Всегда безопасно удалять секреты. Для этого вызовите SecureZeroMemory перед освобождением памяти, используемой для хранения секрета.
  • Безопасно сбрасывайте секреты сразу после их использования.
  • Безопасное удаление секретов, если они не используются по назначению в течение ожидаемого периода времени.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header credentialprovider.h