LSA_AP_CALL_PACKAGE fungsi panggilan balik (ntsecpkg.h)

Artikel
08/25/2023

Dipanggil oleh Otoritas Keamanan Lokal (LSA) ketika aplikasi masuk dengan koneksi tepercaya ke LSA memanggil fungsi LsaCallAuthenticationPackage dan menentukan pengidentifikasi paket autentikasi.

LsaApCallPackage hanya dipanggil untuk aplikasi masuk; panggilan dari aplikasi yang tidak memiliki hak istimewa SeTcbPrivilege dirutekan ke fungsi LsaApCallPackageUntrusted paket autentikasi yang ditentukan sebagai gantinya.

Sintaks

LSA_AP_CALL_PACKAGE LsaApCallPackage;

NTSTATUS LsaApCallPackage(
  [in]  PLSA_CLIENT_REQUEST ClientRequest,
  [in]  PVOID ProtocolSubmitBuffer,
  [in]  PVOID ClientBufferBase,
  [in]  ULONG SubmitBufferLength,
  [out] PVOID *ProtocolReturnBuffer,
  [out] PULONG ReturnBufferLength,
  [out] PNTSTATUS ProtocolStatus
)
{...}

Parameter

[in] ClientRequest

Arahkan ke buffer LSA_CLIENT_REQUEST buram yang mewakili permintaan klien LSA.

[in] ProtocolSubmitBuffer

Menyediakan pesan protokol khusus untuk paket autentikasi.

[in] ClientBufferBase

Menyediakan alamat dalam proses klien pesan protokol. Ini mungkin diperlukan untuk memetakan ulang penunjuk apa pun dalam buffer ProtocolSubmitBuffer .

[in] SubmitBufferLength

Menentukan panjang buffer ProtocolSubmitBuffer , dalam byte.

[out] ProtocolReturnBuffer

Mengembalikan alamat buffer output dalam proses klien. Paket autentikasi bertanggung jawab untuk memanggil fungsi AllocateClientBuffer untuk mengalokasikan buffer dalam proses klien. Isi buffer ini khusus untuk paket autentikasi.

[out] ReturnBufferLength

Penunjuk ke ULONG yang mengembalikan panjang buffer ProtocolReturnBuffer , dalam byte.

[out] ProtocolStatus

Arahkan ke nilai NTSTATUS. Jika fungsi mengembalikan STATUS_SUCCESS, ProtocolStatus mengembalikan status penyelesaian yang ditetapkan oleh paket autentikasi. Nilai ProtocolStatus khusus untuk paket autentikasi.

Informasi lebih lanjut tentang kode NTSTATUS dapat ditemukan di file Subauth.h yang dikirim dengan Platform SDK.

Mengembalikan nilai

Jika fungsi berhasil, kembalikan STATUS_SUCCESS. Nilai pengembalian ini menunjukkan bahwa paket autentikasi mencoba menyediakan layanan yang diminta. Gunakan parameter ProtocolStatus untuk mengembalikan status penyelesaian permintaan layanan.

Jika paket autentikasi tidak dapat memproses permintaan dan karena itu tidak mencoba menyediakan layanan yang diminta, kembalikan kode NTSTATUS yang menunjukkan masalah. Kode ini bisa menjadi nilai berikut atau salah satu Nilai Pengembalian Fungsi Kebijakan LSA.

Menampilkan kode	Deskripsi
STATUS_NO_MEMORY	Kuota memori klien tidak cukup untuk mengalokasikan buffer output.

Keterangan

Fungsi ini harus diimplementasikan oleh paket autentikasi.

Persyaratan


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

AllocateClientBuffer

LsaApCallPackageUntrusted

LsaCallAuthenticationPackage