Fungsi CredEnumerateA (wincred.h)

Artikel
11/20/2024

Fungsi CredEnumerate menghitung 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 CredEnumerateA(
  [in]  LPCSTR       Filter,
  [in]  DWORD        Flags,
  [out] DWORD        *Count,
  [out] PCREDENTIALA **Credential
);

Parameter

[in] Filter

Penunjuk ke string nulldihentikan 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 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	Arti
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 tidak 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

Penunjuk ke array pointer ke kredensial. Kredensial yang dikembalikan adalah satu blok yang dialokasikan. 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.

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 tidak NULL .

Komentar

Nota

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

Syarat	Nilai
klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Platform Target	Windows
Header	wincred.h
Pustaka	Advapi32.lib
DLL	Advapi32.dll

Lihat juga

CredFree

GetLastError

Bagikan melalui