ICredentialProviderUser::GetStringValue メソッド (credentialprovider.h)

入力値に基づいて ICredentialProviderUser オブジェクトから文字列プロパティを取得します。

構文

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

[in] key

取得するプロパティを指定する次のいずれかの値。

REFPROPERTYKEY	説明	適用対象...
PKEY_Identity_DisplayName	わかりやすいユーザー名。	ログオン UI と資格情報 UI
PKEY_Identity_LogonStatusString	ユーザーのログオン状態を示すローカライズされた文字列。	ログオン UI のみ
PKEY_Identity_PrimarySid	ユーザーの SID。	ログオン UI と資格情報 UI
PKEY_Identity_ProviderID	ユーザーのプロバイダー ID。	ログオン UI と資格情報 UI
PKEY_Identity_QualifiedUserName	認証バッファーのパックに使用される名前。	ログオン UI と資格情報 UI
PKEY_Identity_UserName	ユーザー名です。	ログオン UI と資格情報 UI

[out] stringValue

このメソッドが正常に返されると、要求された文字列を受け取るバッファーへのポインターのアドレス。

このメソッドは、成功すると S_OK を返します。そうでない場合は、HRESULT エラーコードを返します。

これらの各値は、ICredentialProviderUser::GetValue を使用して PROPVARIANT として取得することもできます。

次のユーザーを含むシナリオを考えてみましょう。

このシナリオでは、次の表に、各キー値のサンプルデータを示します。

REFPROPERTYKEY	ドメインユーザー	ローカルユーザー	Microsoft アカウント
PKEY_Identity_DisplayName	"Lisa Andrews"	"Lisa Andrews"	"Lisa Andrews"
PKEY_Identity_LogonStatusString	"サインイン"	"Locked"	"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"	"<アカウントプロバイダー名>\lisa@contoso.com"
PKEY_Identity_UserName	"contoso\lisa"	"lisa"	"lisa@contoso.com"