Metode ICredentialProviderUser::GetStringValue (credentialprovider.h)
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
| 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 |