LSA_AP_CALL_PACKAGE_PASSTHROUGH fungsi panggilan balik (ntsecpkg.h)

Artikel
02/29/2024

Fungsi pengiriman untuk permintaan masuk pass-through yang dikirim ke fungsi LsaCallAuthenticationPackage .

Sintaks

LSA_AP_CALL_PACKAGE_PASSTHROUGH LsaApCallPackagePassthrough;

NTSTATUS LsaApCallPackagePassthrough(
  [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

Penunjuk ke buffer LSA_CLIENT_REQUEST buram yang mewakili permintaan klien LSA.

[in] ProtocolSubmitBuffer

Menyediakan pesan khusus protokol ke paket autentikasi.

[in] ClientBufferBase

Menyediakan alamat dalam proses klien pesan protokol. Ini mungkin diperlukan untuk memetakan ulang pointer dalam 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

Penunjuk 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.

Nilai kembali

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 oleh 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

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

AllocateClientBuffer

LsaCallAuthenticationPackage