Fungsi CredRenameA (wincred.h)

[CredRename tidak lagi didukung. Dimulai dengan Windows Vista, panggilan ke CredRename selalu mengembalikan ERROR_NOT_SUPPORTED.]

Fungsi CredRename mengganti nama kredensial dalam kumpulan kredensial pengguna. Set kredensial yang digunakan adalah yang terkait dengan sesi masuk token saat ini. Token tidak boleh menonaktifkan SID pengguna.

Sintaksis

BOOL CredRenameA(
  [in] LPCSTR OldTargetName,
  [in] LPCSTR NewTargetName,
  [in] DWORD  Type,
  [in] DWORD  Flags
);

Parameter

[in] OldTargetName

Penunjuk ke string yang dihentikan null yang berisi nama kredensial saat ini yang akan diganti namanya.

[in] NewTargetName

Penunjuk ke string null-terminated yang berisi nama baru untuk kredensial.

[in] Type

Jenis kredensial yang akan diganti namanya. Harus salah satu definisi CRED_TYPE_*.

[in] Flags

Bendera untuk mengontrol operasi fungsi. Saat ini 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 OldTargetName yang ditentukan.

• ERROR_ALREADY_EXISTS

  Sudah ada kredensial atau ketik Jenis dan bernama NewTargetName.

• 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

Persyaratan