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.
Sintaks
BOOL CredReadA(
[in] LPCSTR TargetName,
[in] DWORD Type,
[in] DWORD Flags,
[out] PCREDENTIALA *Credential
);
Parameter
[in] TargetName
Penunjuk ke string yang dihentikan null yang berisi nama kredensial yang akan dibaca.
[in] Type
Jenis kredensial yang akan dibaca. Jenis harus salah satu dari 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 penunjuk ke lokasi dalam blok yang dialokasikan tunggal ini. Buffer tunggal yang dikembalikan harus dibebaskan dengan memanggil CredFree.
Nilai kembali
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:
- 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 .
Keterangan
Jika nilai anggota Jenis struktur KREDENSIAL yang ditentukan oleh parameter KredensialCRED_TYPE_DOMAIN_EXTENDED, namespace harus ditentukan dalam nama target. Fungsi ini hanya dapat mengembalikan satu kredensial dari jenis yang ditentukan.
Catatan
Header wincred.h mendefinisikan CredRead 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 |
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk