Fungsi LsaGetLogonSessionData (ntsecapi.h)

  • Artikel

Fungsi LsaGetLogonSessionData mengambil informasi tentang sesi masuk tertentu.

Untuk mengambil informasi tentang sesi masuk, pemanggil harus menjadi pemilik sesi atau administrator sistem lokal.

Sintaks

NTSTATUS LsaGetLogonSessionData(
  [in]  PLUID                        LogonId,
  [out] PSECURITY_LOGON_SESSION_DATA *ppLogonSessionData
);

Parameter

[in] LogonId

Menentukan penunjuk ke LUID yang mengidentifikasi sesi masuk yang informasinya akan diambil. Untuk informasi tentang nilai yang valid untuk parameter ini, lihat Keterangan.

[out] ppLogonSessionData

Alamat penunjuk ke struktur SECURITY_LOGON_SESSION_DATA yang berisi informasi tentang sesi masuk yang ditentukan oleh LogonId. Struktur ini dialokasikan oleh LSA. Ketika informasi tidak lagi diperlukan, panggil fungsi LsaFreeReturnBuffer untuk membebaskan memori yang digunakan oleh struktur ini.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan STATUS_SUCCESS.

Jika fungsi gagal, nilai yang dikembalikan adalah kode NTSTATUS yang menunjukkan alasannya.

Keterangan

Untuk mendapatkan pengidentifikasi sesi masuk yang valid yang dapat diteruskan ke parameter LogonId fungsi ini, panggil fungsi LsaEnumerateLogonSessions .

Jika LogonID menentukan akun LocalSystem (0x0:0x3e7), maka fungsi ini mengembalikan nol untuk data sesi masuk yang diambil di ppLogonSessionData. Alasannya adalah bahwa akun LocalSystem tidak masuk dengan cara masuk yang khas. Sebaliknya, akun LocalSystem aktif setelah sistem dimulai.

Persyaratan

   
Klien minimum yang didukung Windows XP [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Target Platform Windows
Header ntsecapi.h
Pustaka Secur32.lib
DLL Secur32.dll