LSA_ALLOCATE_CLIENT_BUFFER fungsi panggilan balik (ntsecpkg.h)

  • Artikel

Mengalokasikan buffer di ruang alamat klien. Buffer yang dialokasikan di ruang alamat klien digunakan untuk menyimpan informasi yang dikembalikan ke klien dari paket autentikasi.

Sintaks

LSA_ALLOCATE_CLIENT_BUFFER LsaAllocateClientBuffer;

NTSTATUS LsaAllocateClientBuffer(
  [in]  PLSA_CLIENT_REQUEST ClientRequest,
  [in]  ULONG LengthRequired,
  [out] PVOID *ClientBaseAddress
)
{...}

Parameter

[in] ClientRequest

Arahkan ke struktur data LSA_CLIENT_REQUEST buram yang berisi informasi tentang permintaan autentikasi klien LSA. Paket autentikasi kustom harus meneruskan nilai yang diterima selama panggilan klien ke fungsi, seperti LsaApCallPackage atau LsaApLogonUser, yang mengembalikan parameter output.

[in] LengthRequired

Panjang buffer yang diperlukan, dalam byte.

[out] ClientBaseAddress

Pointer yang menerima alamat buffer. Alamat ini adalah alamat virtual buffer dalam proses klien, bukan dalam proses saat ini.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah STATUS_SUCCESS.

Jika fungsi gagal, nilai yang dikembalikan adalah kode NTSTATUS, yang dapat menjadi nilai berikut atau salah satu Nilai Pengembalian Fungsi Kebijakan LSA.

Menampilkan kode Deskripsi
STATUS_NO_MEMORY
 Proses klien tidak memiliki kuota memori yang memadai untuk mengalokasikan buffer.
 

Fungsi LsaNtStatusToWinError mengonversi kode NTSTATUS menjadi kode kesalahan Windows.

Keterangan

Paket autentikasi atau proses klien nantinya harus membebaskan buffer. Proses autentikasi dapat membebaskan buffer dengan menggunakan rutinitas pengiriman FreeClientBuffer . Proses klien dapat membebaskan buffer dengan menggunakan fungsi LsaFreeReturnBuffer .

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

LSA_DISPATCH_TABLE

LSA_SECPKG_FUNCTION_TABLE