Metode ICredentialProviderCredential::GetStringValue (credentialprovider.h)

Mengaktifkan pengambilan teks dari kredensial dengan bidang teks.

Sintaks

HRESULT GetStringValue(
  [in]  DWORD  dwFieldID,
  [out] LPWSTR *ppsz
);

Parameter

[in] dwFieldID

Jenis: DWORD

Pengidentifikasi untuk bidang .

[out] ppsz

Jenis: LPWSTR*

Penunjuk ke memori yang berisi string Unicode yang dihentikan null untuk kembali ke UI Logon atau Antarmuka Pengguna Kredensial.

Mengembalikan nilai

Jenis: HRESULT

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

Keterangan

Metode ini bersifat opsional.

UI Masuk dan UI Kredensial memberi kami metode ini untuk mendapatkan pszLabel untuk bidang . Informasi ini diperlukan untuk mendapatkan nilai untuk bidang CPFT_LARGE_TEXT, CPFT_SMALL_TEXT, CPFT_COMMAND_LINK, CPFT_EDIT_TEXT, dan CPFT_PASSWORD_TEXT .

Praktik Terbaik Penyedia Kredensial

Penyedia info masuk menangani rahasia pengguna yang sangat sensitif untuk menyelesaikan permintaan masuk dan membuka kunci. Sebagai praktik terbaik, informasi rahasia seperti kata sandi dan VPN harus ditangani dengan sangat hati-hati. Teknik yang tepat untuk menangani informasi rahasia dalam penyedia kredensial adalah:

• Selalu buang rahasia dengan aman. Untuk melakukan ini, panggil SecureZeroMemory sebelum membebaskan memori yang digunakan untuk menyimpan rahasia apa pun.
• Buang rahasia dengan aman segera setelah digunakan.
• Buang rahasia dengan aman jika tidak digunakan untuk tujuan yang dimaksudkan dalam jumlah waktu yang diharapkan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	credentialprovider.h