Bagikan melalui


Fungsi CredDeleteA (wincred.h)

Fungsi CredDelete menghapus 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 CredDeleteA(
  [in] LPCSTR TargetName,
  [in] DWORD  Type,
  [in] DWORD  Flags
);

Parameter

[in] TargetName

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

[in] Type

Jenis kredensial yang akan dihapus. Harus salah satu jenis yang ditentukan CRED_TYPE_*. Untuk daftar jenis yang ditentukan, lihat anggota Jenis dari struktur KREDENSIAL .

Jika nilai parameter ini CRED_TYPE_DOMAIN_EXTENDED, fungsi ini dapat menghapus kredensial yang menentukan nama pengguna ketika ada beberapa kredensial untuk target yang sama. Nilai parameter TargetName harus menentukan nama pengguna sebagai TargetUserName.

[in] Flags

Dicadangkan dan harus nol.

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

Nota

Header wincred.h mendefinisikan CredDelete 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