Fungsi panggilan balik PFNRASRETRIEVEBUFFER (ras.h)

DLL skrip kustom memanggil fungsi RasRetrieveBuffer untuk mendapatkan data yang diterima dari server RAS melalui port yang ditentukan. DLL skrip kustom harus memanggil RasRetrieveBuffer hanya setelah RAS memberi sinyal objek peristiwa yang diteruskan dalam panggilan ke RasReceiveBuffer.

Jenis PFNRASRETRIEVEBUFFER mendefinisikan penunjuk ke fungsi panggilan balik ini. RasRetrieveBuffer adalah tempat penampung untuk nama fungsi yang ditentukan aplikasi.

Sintaks

PFNRASRETRIEVEBUFFER Pfnrasretrievebuffer;

DWORD Pfnrasretrievebuffer(
  HANDLE hPort,
  PBYTE pBuffer,
  PDWORD pdwSize
)
{...}

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 . Nilai parameter ini mungkin sama dengan penunjuk ke buffer yang diteruskan ke fungsi RasReceiveBuffer .

pdwSize

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

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah ERROR_SUCCESS.

Jika fungsi gagal, nilai yang dikembalikan bisa 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.

 

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

Keterangan

Fungsi RasRetrieveBuffer sinkron. Ketika kembali, buffer yang ditujukkan oleh parameter pBuffer berisi data yang diterima melalui port yang ditentukan. DLL skrip kustom harus memanggil RasRetrieveBuffer hanya setelah RAS memberi sinyal objek peristiwa yang diteruskan DLL dalam panggilan ke RasReceiveBuffer.

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

Persyaratan

Persyaratan	Nilai
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

Skrip Kustom RAS

RasCustomScriptExecute

RasReceiveBuffer

RasSendBuffer