Metode ICredentialProviderUser::GetStringValue (credentialprovider.h)

  • Artikel

Mengambil properti string dari objek ICredentialProviderUser berdasarkan nilai input.

Sintaks

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

Parameter

[in] key

Salah satu nilai berikut yang menentukan properti yang akan diambil.

REFPROPERTYKEY Deskripsi Berlaku untuk...
PKEY_Identity_DisplayName Nama pengguna yang ramah. UI Log masuk dan Antarmuka Pengguna Kredensial
PKEY_Identity_LogonStatusString String yang dilokalkan yang menunjukkan status pengguna yang masuk. Hanya UI masuk
PKEY_Identity_PrimarySid SID pengguna. UI Log masuk dan Antarmuka Pengguna Kredensial
PKEY_Identity_ProviderID ID penyedia pengguna. UI Log masuk dan Antarmuka Pengguna Kredensial
PKEY_Identity_QualifiedUserName Nama yang digunakan untuk mengemas buffer autentikasi. UI Log masuk dan Antarmuka Pengguna Kredensial
PKEY_Identity_UserName Nama pengguna. UI Log masuk dan Antarmuka Pengguna Kredensial

[out] stringValue

Alamat penunjuk ke buffer yang, ketika metode ini berhasil dikembalikan, menerima string yang diminta.

Nilai kembali

Jika metode ini berhasil, metode ini mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Masing-masing nilai ini juga dapat diambil sebagai PROPVARIANT melalui ICredentialProviderUser::GetValue.

Pertimbangkan skenario dengan pengguna berikut.

  • Pengguna domain:
    • Domain: contoso
    • Nama pengguna: lisa
    • Nama yang mudah diingat: Lisa Andrews
  • Pengguna lokal:
    • Nama PC: lisa-pc
    • Nama pengguna: lisa
    • Nama yang mudah diingat: Lisa Andrews
  • Akun Microsoft:
    • Alamat Email: lisa@contoso.com
    • Nama yang mudah diingat: Lisa Andrews
Dalam skenario ini, tabel berikut ini menyediakan beberapa data sampel untuk setiap nilai kunci .
REFPROPERTYKEY Pengguna domain Pengguna lokal Akun Microsoft
PKEY_Identity_DisplayName "Lisa Andrews" "Lisa Andrews" "Lisa Andrews"
PKEY_Identity_LogonStatusString "Masuk" "Terkunci" "Masuk dari jarak jauh dari 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}" Tidak ditentukan sebelumnya
PKEY_Identity_QualifiedUserName "contoso\lisa" "lisa-pc\lisa" "<nama> penyedia akun\lisa@contoso.com"
PKEY_Identity_UserName "contoso\lisa" "lisa" "lisa@contoso.com"

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 8 [khusus aplikasi desktop]
Server minimum yang didukung Windows Server 2012 [hanya aplikasi desktop]
Target Platform Windows
Header credentialprovider.h
Pustaka CredentialProvider.lib
DLL Authui.dll

Lihat juga

ICredentialProviderUser

ICredentialProviderUser::GetValue