Fungsi CredReadA (wincred.h)

Fungsi CredRead membaca kredensial dari kumpulan kredensial pengguna. Set kredensial yang digunakan adalah yang terkait dengan sesi masuk token saat ini. Token tidak boleh menonaktifkan SID pengguna.

Sintaksis

BOOL CredReadA(
  [in]  LPCSTR       TargetName,
  [in]  DWORD        Type,
  [in]  DWORD        Flags,
  [out] PCREDENTIALA *Credential
);

Parameter

[in] TargetName

Penunjuk ke string null-terminated yang berisi nama kredensial yang akan dibaca.

[in] Type

Jenis kredensial yang akan dibaca. Tipe harus salah satu jenis yang ditentukan CRED_TYPE_*.

[in] Flags

Saat ini dicadangkan dan harus nol.

[out] Credential

Penunjuk ke satu buffer blok yang dialokasikan untuk mengembalikan kredensial. Setiap pointer yang terkandung dalam buffer adalah pointer ke lokasi dalam blok yang dialokasikan tunggal ini. Buffer tunggal yang dikembalikan harus dibebaskan dengan memanggil CredFree.

Mengembalikan nilai

Fungsi mengembalikan TRUE pada keberhasilan dan FALSE gagal. Fungsi GetLastError dapat dipanggil untuk mendapatkan kode status yang lebih spesifik. Kode status berikut dapat dikembalikan:

• ERROR_NOT_FOUND

  Tidak ada kredensial dengan TargetName yang ditentukan.

• ERROR_NO_SUCH_LOGON_SESSION

  Sesi masuk tidak ada atau tidak ada set kredensial yang terkait dengan sesi masuk ini. Sesi masuk jaringan tidak memiliki set kredensial terkait.

• ERROR_INVALID_FLAGS

  Bendera yang tidak valid ditentukan untuk parameter Bendera .

Komentar

Jika nilai Jenis anggota struktur KREDENSIAL yang ditentukan oleh parameter Kredensial CRED_TYPE_DOMAIN_EXTENDED, namespace harus ditentukan dalam nama target. Fungsi ini hanya dapat mengembalikan satu kredensial dari jenis yang ditentukan.

Persyaratan