Fungsi FreeCredentialsHandle (sspi.h)

Fungsi FreeCredentialsHandle memberi tahu sistem keamanan bahwa kredensial tidak lagi diperlukan. Aplikasi memanggil fungsi ini untuk membebaskan handel kredensial yang diperoleh dalam panggilan ke fungsi AcquireCredentialsHandle (Umum) setelah memanggil fungsi DeleteSecurityContext untuk membebaskan handel konteks apa pun yang terkait dengan kredensial. Ketika semua referensi ke set kredensial ini telah dihapus, kredensial itu sendiri dapat dihapus.

Kegagalan untuk handel kredensial bebas akan mengakibatkan kebocoran memori.

Sintaks

KSECDDDECLSPEC SECURITY_STATUS SEC_ENTRY FreeCredentialsHandle(
  [in] PCredHandle phCredential
);

Parameter

[in] phCredential

Penunjuk ke handel CredHandle yang diperoleh dengan menggunakan fungsi AcquireCredentialsHandle (Umum).

Mengembalikan nilai

Jika fungsi berhasil, fungsi akan mengembalikan SEC_E_OK.

Jika fungsi gagal, fungsi mengembalikan kode kesalahan berikut.

Menampilkan kode	Deskripsi
SEC_E_INVALID_HANDLE	Handel yang diteruskan ke fungsi tidak valid.

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	sspi.h (termasuk Security.h)
Pustaka	Secur32.lib
DLL	Secur32.dll

Lihat juga

AcquireCredentialsHandle (Umum)

Fungsi SSPI