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

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

  • Статья

Извлекает строковые свойства из объекта ICredentialProviderUser на основе входного значения.

Синтаксис

HRESULT GetStringValue(
  [in]  REFPROPERTYKEY key,
  [out] LPWSTR         *stringValue
);

Параметры

[in] key

Одно из следующих значений, задающее извлекаемое свойство.

REFPROPERTYKEY Описание Применимо к...
PKEY_Identity_DisplayName Понятное имя пользователя. Пользовательский интерфейс входа и пользовательский интерфейс учетных данных
PKEY_Identity_LogonStatusString Локализованная строка, указывающая состояние пользователя, вошедшего в систему. Только пользовательский интерфейс входа
PKEY_Identity_PrimarySid Идентификатор безопасности пользователя. Пользовательский интерфейс входа и пользовательский интерфейс учетных данных
PKEY_Identity_ProviderID Идентификатор поставщика пользователя. Пользовательский интерфейс входа и пользовательский интерфейс учетных данных
PKEY_Identity_QualifiedUserName Имя, используемое для упаковки буфера проверки подлинности. Пользовательский интерфейс входа и пользовательский интерфейс учетных данных
PKEY_Identity_UserName Имя пользователя. Пользовательский интерфейс входа и пользовательский интерфейс учетных данных

[out] stringValue

Адрес указателя на буфер, который при успешном возврате этого метода получает запрошенную строку.

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

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

Комментарии

Каждое из этих значений также можно получить в виде PROPVARIANT через ICredentialProviderUser::GetValue.

Рассмотрим сценарий со следующими пользователями.

  • Пользователь домена:
    • Домен: contoso
    • Имя пользователя: lisa
    • Понятное имя: Лиза Эндрюс
  • Локальный пользователь:
    • Имя компьютера: lisa-pc
    • Имя пользователя: lisa
    • Понятное имя: Лиза Эндрюс
  • Учетная запись Майкрософт.
    • Адрес электронной почты: lisa@contoso.com
    • Понятное имя: Лиза Эндрюс
В этом сценарии в следующей таблице приведены некоторые примеры данных для каждого из значений ключей .
REFPROPERTYKEY Пользователь домена Локальный пользователь Учетная запись Майкрософт
PKEY_Identity_DisplayName "Лиза Эндрюс" "Лиза Эндрюс" "Лиза Эндрюс"
PKEY_Identity_LogonStatusString "Вход" "Заблокировано" "Удаленный вход с помощью lisa-pc"
PKEY_Identity_PrimarySid "{S-1-5-21-2279990834-2601404236-735077814-1001}" "{S-1-5-21-2279990834-2601404236-735077814-1001}" "{S-1-5-21-2279990834-2601404236-735077814-1001}"
PKEY_Identity_ProviderID "{A198529B-730F-4089-B646-A12557F5665E}" "{A198529B-730F-4089-B646-A12557F5665E}" Не определено предварительно
PKEY_Identity_QualifiedUserName "contoso\lisa" "lisa-pc\lisa" "<account provider name>\lisa@contoso.com"
PKEY_Identity_UserName "contoso\lisa" "лиза" "lisa@contoso.com"

Требования

Требование Значение
Минимальная версия клиента Windows 8 [только классические приложения]
Минимальная версия сервера Windows Server 2012 [только классические приложения]
Целевая платформа Windows
Header credentialprovider.h
Библиотека CredentialProvider.lib
DLL Authui.dll

См. также раздел

ICredentialProviderUser

ICredentialProviderUser::GetValue