Fungsi panggilan balik PFNRASGETBUFFER (ras.h)

DLL skrip kustom memanggil RasGetBuffer untuk mengalokasikan memori untuk mengirim atau menerima data melalui port yang terhubung ke server.

Sintaks

PFNRASGETBUFFER Pfnrasgetbuffer;

DWORD Pfnrasgetbuffer(
  PBYTE *ppBuffer,
  PDWORD pdwSize
)
{...}

Parameter

ppBuffer

Penunjuk ke penunjuk yang menerima alamat buffer yang dikembalikan.

pdwSize

Penunjuk ke variabel DWORD yang, pada input, berisi ukuran buffer yang diminta. Pada output, variabel ini berisi ukuran aktual buffer yang dialokasikan.

Menampilkan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah ERROR_SUCCESS.

Jika fungsi gagal, nilai yang dikembalikan adalah kode kesalahan berikut.

Nilai Makna
ERROR_OUT_OF_BUFFERS
RAS tidak dapat mengalokasikan ruang buffer lagi.

Keterangan

Ukuran buffer maksimum yang dapat diperoleh adalah 1500 byte.

DLL skrip kustom memanggil RasGetBuffer melalui penunjuk fungsi. Penunjuk fungsi diteruskan ke DLL skrip kustom sebagai parameter ketika RAS memanggil implementasi DLL dari RasCustomScriptExecute.

Persyaratan

   
Klien minimum yang didukung Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung Windows 2000 Server [hanya aplikasi desktop]
Target Platform Windows
Header ras.h

Lihat juga

Pembuatan Skrip Kustom RAS

RasCustomScriptExecute

RasFreeBuffer