Fungsi CredEnumerateA (wincred.h)

  • Artikel

Fungsi CredEnumerate menghitung kredensial dari set kredensial pengguna. Set kredensial yang digunakan adalah yang terkait dengan sesi masuk token saat ini. Token tidak boleh menonaktifkan SID pengguna.

Sintaks

BOOL CredEnumerateA(
  [in]  LPCSTR       Filter,
  [in]  DWORD        Flags,
  [out] DWORD        *Count,
  [out] PCREDENTIALA **Credential
);

Parameter

[in] Filter

Penunjuk ke string yang dihentikan null yang berisi filter untuk kredensial yang dikembalikan. Hanya kredensial dengan TargetName yang cocok dengan filter yang akan dikembalikan. Filter menentukan awalan nama diikuti dengan tanda bintang. Misalnya, filter "FRED*" akan mengembalikan semua kredensial dengan TargetName yang dimulai dengan string "FRED".

Jika NULL ditentukan, semua kredensial akan dikembalikan.

[in] Flags

Nilai parameter ini bisa nol atau lebih dari nilai berikut yang dikombinasikan dengan operasi bitwise-OR.

Nilai Makna
CRED_ENUMERATE_ALL_CREDENTIALS
0x1
 Fungsi ini menghitung semua kredensial dalam kumpulan kredensial pengguna. Nama target setiap kredensial dikembalikan dalam format "namespace:attribute=target". Jika bendera ini diatur dan parameter Filter bukan NULL, fungsi gagal dan mengembalikan ERROR_INVALID_FLAGS.

Windows Server 2003 dan Windows XP: Bendera ini tidak didukung.

[out] Count

Jumlah kredensial yang dikembalikan dalam array Kredensial .

[out] Credential

Arahkan ke array pointer ke kredensial. Kredensial yang dikembalikan adalah satu blok yang dialokasikan. Setiap pointer yang terkandung dalam buffer adalah penunjuk ke lokasi dalam blok yang dialokasikan tunggal ini. Buffer tunggal yang dikembalikan harus dikosongkan dengan memanggil CredFree.

Mengembalikan nilai

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

Mengembalikan kode/nilai Deskripsi
ERROR_NOT_FOUND
1168 (0x490)
 Tidak ada kredensial yang cocok dengan Filter yang ditentukan.
ERROR_NO_SUCH_LOGON_SESSION
1312 (0x520)
 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
1004 (0x3EC)
 Bendera yang tidak valid ditentukan untuk parameter Bendera , atau CRED_ENUMERATE_ALL_CREDENTIALS ditentukan untuk parameter Bendera dan parameter Filter bukan NULL.

Keterangan

Catatan

Header wincred.h mendefinisikan CredEnumerate sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor 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 Advapi32.lib
DLL Advapi32.dll

Lihat juga

CredFree

GetLastError