Fungsi CredUIConfirmCredentialsA (wincred.h)

  • Artikel

Fungsi CredUIConfirmCredentials dipanggil setelah CredUIPromptForCredentials atau CredUICmdLinePromptForCredentials, untuk mengonfirmasi validitas kredensial yang dipanen. CredUIConfirmCredentials harus dipanggil jika bendera CREDUI_FLAGS_EXPECT_CONFIRMATION diteruskan ke fungsi "prompt", baik CredUIPromptForCredentials atau CredUICmdLinePromptForCredentials, dan fungsi "prompt" dikembalikan NO_ERROR.

Setelah memanggil fungsi "prompt" dan sebelum memanggil CredUIConfirmCredentials, pemanggil harus menentukan apakah kredensial benar-benar valid dengan menggunakan kredensial untuk mengakses sumber daya yang ditentukan oleh pszTargetName. Hasil tes validasi tersebut diteruskan ke CredUIConfirmCredentials dalam parameter bConfirm .

Sintaks

CREDUIAPI DWORD CredUIConfirmCredentialsA(
  [in] PCSTR pszTargetName,
  [in] BOOL  bConfirm
);

Parameter

[in] pszTargetName

Penunjuk ke string yang dihentikan null yang berisi nama target untuk kredensial, biasanya nama aplikasi domain atau server. Nilai ini harus sama dengan pszTargetName ke CredUIPromptForCredentials atau CredUICmdLinePromptForCredentials

[in] bConfirm

Menentukan apakah kredensial yang dikembalikan dari fungsi prompt valid. Jika TRUE, kredensial disimpan di manajer kredensial seperti yang didefinisikan oleh CredUIPromptForCredentials atau CredUICmdLinePromptForCredentials. Jika FALSE, kredensial tidak disimpan dan berbagai bagian memori dibersihkan.

Mengembalikan nilai

Status operasi dikembalikan. Penelepon dapat memeriksa status ini untuk menentukan apakah operasi konfirmasi kredensial berhasil. Sebagian besar aplikasi mengabaikan kode status ini karena koneksi aplikasi ke sumber daya telah dilakukan. Operasi dapat gagal karena kredensial tidak ditemukan pada daftar kredensial yang menunggu konfirmasi, atau karena upaya untuk menulis atau menghapus kredensial gagal. Kegagalan menemukan kredensial dalam daftar dapat terjadi karena kredensial tidak pernah diantrekan atau sebagai akibat dari terlalu banyak kredensial yang diantrekan. Hingga lima kredensial dapat diantrekan sebelum kredensial yang lebih lama dibuang karena kredensial yang lebih baru diantrekan.

Menampilkan kode Deskripsi
NO_ERROR - (nol)
 Konfirmasi operasi berhasil.
ERROR_NOT_FOUND
 Kredensial subjek tidak dapat ditemukan pada daftar tunggu konfirmasi.
ERROR_INVALID_PARAMETER
 Upaya untuk mengonfirmasi kredensial tunggu gagal karena kredensial berisi data yang tidak valid atau tidak konsisten.

Keterangan

Catatan

Header wincred.h mendefinisikan CredUIConfirmCredentials sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows XP [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Target Platform Windows
Header wincred.h
Pustaka Credui.lib
DLL Credui.dll