LSA_DELETE_LOGON_SESSION fungsi panggilan balik (ntsecpkg.h)

  • Artikel

Membersihkan sesi masuk apa pun yang dibuat sambil menentukan apakah informasi autentikasi pengguna sah.

Jika autentikasi gagal, paket autentikasi harus menghapus semua sesi masuk terkait.

Sintaks

LSA_DELETE_LOGON_SESSION LsaDeleteLogonSession;

NTSTATUS LsaDeleteLogonSession(
  [in] PLUID LogonId
)
{...}

Parameter

[in] LogonId

Penunjuk ke struktur LUID yang berisi ID sesi masuk untuk dihapus.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah STATUS_SUCCESS.

Jika fungsi gagal, nilai yang dikembalikan adalah kode NTSTATUS, yang dapat menjadi salah satu nilai berikut atau salah satu Nilai Pengembalian Fungsi Kebijakan LSA.

Menampilkan kode Deskripsi
STATUS_BAD_LOGON_SESSION_STATE
 Sesi masuk yang ditentukan memiliki nilai jumlah referensi yang mencegahnya dihapus. Ini adalah masalah serius, yang disebabkan oleh sistem operasi dan paket autentikasi yang percaya bahwa mereka memiliki otoritas atas sesi masuk.
STATUS_NO_SUCH_LOGON_SESSION
 Sesi masuk yang ditentukan tidak dapat ditemukan.
 

Fungsi LsaNtStatusToWinError mengonversi kode NTSTATUS menjadi kode kesalahan Windows.

Keterangan

Karena sesi masuk menggunakan memori di kernel, sesi masuk yang tidak digunakan atau dibuang harus dihapus. Namun, sesi masuk tidak boleh dihapus setelah ID masuk untuk sesi dikembalikan ke LSA. Setelah LSA diberi ID masuk (misalnya, sebagai akibat dari panggilan LsaApLogonUser ), LSA mengasumsikan bahwa LSA bertanggung jawab atas sesi masuk dan akan menghapusnya ketika sistem operasi tidak lagi membutuhkannya. Saat ini, LSA memanggil LsaApLogonTerminated untuk memberi tahu paket autentikasi bahwa sesi telah dihapus.

Sebaliknya, paket autentikasi tidak diberi tahu ketika sesi masuk dihapus dengan DeleteLogonSession.

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 ntsecpkg.h

Lihat juga

CreateLogonSession

LSA_DISPATCH_TABLE

LSA_SECPKG_FUNCTION_TABLE