Fungsi LsaRegisterLogonProcess (ntsecapi.h)

  • Artikel

Fungsi LsaRegisterLogonProcess membuat koneksi ke server LSA dan memverifikasi bahwa pemanggil adalah aplikasi masuk.

Sintaks

NTSTATUS LsaRegisterLogonProcess(
  [in]  PLSA_STRING           LogonProcessName,
  [out] PHANDLE               LsaHandle,
  [out] PLSA_OPERATIONAL_MODE SecurityMode
);

Parameter

[in] LogonProcessName

Arahkan ke struktur LSA_STRING yang mengidentifikasi aplikasi masuk. Ini harus menjadi nama yang dapat dicetak yang cocok untuk ditampilkan kepada administrator. Misalnya, aplikasi masuk Windows mungkin menggunakan nama "User32LogonProcess". Nama ini digunakan oleh LSA selama audit. LsaRegisterLogonProcess tidak memeriksa apakah nama sudah digunakan.

String ini tidak boleh melebihi 127 byte.

[out] LsaHandle

Pointer yang menerima handel yang digunakan dalam panggilan fungsi autentikasi di masa mendatang.

[out] SecurityMode

Nilai yang dikembalikan tidak bermakna dan harus diabaikan.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan STATUS_SUCCESS.

Jika fungsi gagal, nilai yang dikembalikan adalah kode NTSTATUS. Berikut ini adalah kemungkinan kode kesalahan.

Menampilkan kode Deskripsi
STATUS_PORT_CONNECTION_REFUSED
 Pemanggil tidak memiliki hak istimewa SeTcbPrivilege, yang diperlukan untuk memanggil fungsi ini.

Anda dapat mengatur hak istimewa ini dengan memanggil LsaAddAccountRights.
STATUS_NAME_TOO_LONG
 Nama proses masuk yang ditentukan melebihi 127 byte.
 

Untuk informasi selengkapnya, lihat Nilai Pengembalian Fungsi Kebijakan LSA.

Fungsi LsaNtStatusToWinError mengonversi kode NTSTATUS ke kode kesalahan Windows.

Keterangan

Fungsi ini harus dipanggil sebelum proses masuk dapat menggunakan fungsi autentikasi masuk lainnya yang disediakan oleh LSA.

Fungsi LsaRegisterLogonProcess memverifikasi bahwa aplikasi yang melakukan panggilan fungsi adalah proses masuk dengan memeriksa bahwa ia memiliki set hak istimewa SeTcbPrivilege. Ini juga membuka proses aplikasi untuk akses PROCESS_DUP_HANDLE untuk mengantisipasi panggilan autentikasi LSA di masa mendatang. Untuk informasi selengkapnya, lihat DuplicateHandle.

Setelah Anda selesai menggunakan koneksi ke server LSA, hapus konteks aplikasi masuk pemanggil dan tutup koneksi dengan memanggil fungsi LsaDeregisterLogonProcess .

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 ntsecapi.h
Pustaka Secur32.lib
DLL Secur32.dll

Lihat juga

LsaAddAccountRights

LsaConnectUntrusted

LsaDeregisterLogonProcess