Fungsi panggilan balik PFNRASRECEIVEBUFFER (ras.h)

Artikel
08/25/2023

DLL skrip kustom memanggil fungsi RasReceiveBuffer untuk memberi tahu RAS bahwa IA siap untuk menerima data dari server melalui port yang ditentukan.

Jenis PFNRASRECEIVEBUFFER mendefinisikan pointer ke fungsi panggilan balik ini. RasReceiveBuffer adalah tempat penampung untuk nama fungsi yang ditentukan aplikasi.

Sintaks

PFNRASRECEIVEBUFFER Pfnrasreceivebuffer;

DWORD Pfnrasreceivebuffer(
  HANDLE hPort,
  PBYTE pBuffer,
  PDWORD pdwSize,
  DWORD dwTimeOut,
  HANDLE hEvent
)
{...}

Parameter

hPort

Tangani ke port tempat menerima data. Handel ini harus menjadi handel yang diteruskan oleh RAS sebagai parameter pertama dari fungsi RasCustomScriptExecute .

pBuffer

Arahkan ke buffer untuk menerima data dari port yang ditentukan oleh parameter hPort . Dapatkan buffer ini menggunakan fungsi RasGetBuffer .

pdwSize

Penunjuk ke variabel DWORD yang menerima ukuran data yang dikembalikan dalam buffer yang ditujukkan oleh parameter pBuffer .

dwTimeOut

hEvent

Tangani ke objek peristiwa yang akan disinyalkan RAS saat data yang diterima tersedia.

Menampilkan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah ERROR_SUCCESS.

Jika fungsi gagal, nilai yang dikembalikan dapat menjadi salah satu kode kesalahan berikut.

Nilai	Makna
ERROR_BUFFER_INVALID	Penunjuk ke buffer yang diteruskan dalam parameter pBuffer tidak valid.
ERROR_INVALID_PORT_HANDLE	Handel yang ditentukan oleh parameter hPort tidak valid.

Keterangan

RasReceiveBuffer adalah fungsi asinkron. RasReceiveBuffer segera kembali meskipun data belum tersedia. DLL skrip kustom harus menunggu pada objek peristiwa yang ditentukan oleh parameter hEvent . Saat data tersedia, RAS memberi sinyal peristiwa ini. DLL skrip kustom kemudian harus memanggil fungsi RasRetrieveBuffer untuk mendapatkan data. DLL skrip kustom dapat melewati penunjuk buffer yang sama di RasRetrieveBuffer yang diteruskannya di RasReceiveBuffer.

RAS juga menandakan objek peristiwa jika, karena alasan tertentu, port terputus sebelum data diposting. Dalam hal ini, RasRetrieveBuffer mengembalikan kesalahan yang ditentukan dalam Raserror.h, yang menunjukkan penyebab kegagalan.

DLL skrip kustom memanggil RasReceiveBuffer 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

RasSendBuffer

Share via