LSA_AP_CALL_PACKAGE fungsi panggilan balik (ntsecpkg.h)
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 |
---|---|
|
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 |