ICredentialProviderUser：：GetStringValue 方法 (credentialprovider.h)

根據輸入值，從 ICredentialProviderUser 物件擷取字串屬性。

語法

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

[in] key

下列其中一個值，指定要擷取的屬性。

REFPROPERTYKEY	Description	適用於...
PKEY_Identity_DisplayName	易記的用戶名稱。	登入UI和認證UI
PKEY_Identity_LogonStatusString	表示使用者登入狀態的當地語系化字串。	僅限登入UI
PKEY_Identity_PrimarySid	使用者的 SID。	登入UI和認證UI
PKEY_Identity_ProviderID	使用者的提供者識別碼。	登入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"