PFNRASRECEIVEBUFFER-Rückruffunktion (ras.h)

Artikel
03/05/2025

Die benutzerdefinierte Skripting-DLL ruft die RasReceiveBuffer--Funktion auf, um RAS zu informieren, dass sie bereit ist, Daten vom Server über den angegebenen Port zu empfangen.

Der PFNRASRECEIVEBUFFER Typ definiert einen Zeiger auf diese Rückruffunktion. RasReceiveBuffer ist ein Platzhalter für den anwendungsdefinierte Funktionsnamen.

Syntax

PFNRASRECEIVEBUFFER Pfnrasreceivebuffer;

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

Parameter

hPort

Behandeln Sie den Port, an dem die Daten empfangen werden sollen. Dieses Handle sollte der von RAS übergebene Handle als erster Parameter der RasCustomScriptExecute-Funktion sein.

pBuffer

Zeigen Sie auf einen Puffer, um die Daten vom port zu empfangen, der vom hPort-parameter angegeben wird. Rufen Sie diesen Puffer mit RasGetBuffer--Funktion ab.

pdwSize

Zeiger auf eine DWORD- Variable, die die Größe der im Puffer zurückgegebenen Daten empfängt, auf die der pBuffer-Parameter verweist.

dwTimeOut

hEvent

Behandeln Sie ein Ereignisobjekt, das RAS signalisiert, wenn die empfangenen Daten verfügbar sind.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS.

Wenn die Funktion fehlschlägt, kann der Rückgabewert einer der folgenden Fehlercodes sein.

Wert	Bedeutung
ERROR_BUFFER_INVALID	Der Zeiger auf den Puffer, der im pBuffer Parameter übergeben wird, ist ungültig.
ERROR_INVALID_PORT_HANDLE	Das vom hPort- Parameter angegebene Handle ist ungültig.

Bemerkungen

RasReceiveBuffer ist eine asynchrone Funktion. RasReceiveBuffer sofort zurück, auch wenn die Daten noch nicht verfügbar sind. Die benutzerdefinierte Skripting-DLL muss auf das vom hEvent Parameter angegebene Ereignisobjekt warten. Wenn die Daten verfügbar sind, signalisiert RAS dieses Ereignis. Die DLL für benutzerdefinierte Skripts sollte dann die RasRetrieveBuffer--Funktion aufrufen, um die Daten abzurufen. Die dll für benutzerdefinierte Skripts kann denselben Pufferzeiger in RasRetrieveBuffer übergeben, die er in RasReceiveBufferübergeben hat.

RAS signalisiert auch das Ereignisobjekt, wenn der Port aus irgendeinem Grund getrennt wird, bevor die Daten gepostet werden. In diesem Fall gibt RasRetrieveBuffer einen in Raserror.h definierten Fehler zurück, der die Ursache des Fehlers angibt.

Die benutzerdefinierte Skripting-DLL ruft RasReceiveBuffer über einen Funktionszeiger auf. Der Funktionszeiger wird als Parameter an die benutzerdefinierte Skripting-DLL übergeben, wenn RAS die Implementierung von RasCustomScriptExecuteaufruft.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	ras.h

Siehe auch

ras custom-scripting

RasCustomScriptExecute

RasSendBuffer

Freigeben über