PFNRASRETRIEVEBUFFER-Rückruffunktion (ras.h)
Die DLL für benutzerdefinierte Skripterstellung ruft die RasRetrieveBuffer-Funktion auf, um Daten abzurufen, die vom RAS-Server über den angegebenen Port empfangen werden. Die DLL für benutzerdefinierte Skripterstellung sollte RasRetrieveBuffer erst aufrufen, nachdem RAS signalisiert hat, dass das Ereignisobjekt im Aufruf von RasReceiveBuffer übergeben wurde.
Der PFNRASRETRIEVEBUFFER-Typ definiert einen Zeiger auf diese Rückruffunktion. RasRetrieveBuffer ist ein Platzhalter für den anwendungsdefinierte Funktionsnamen.
Syntax
PFNRASRETRIEVEBUFFER Pfnrasretrievebuffer;
DWORD Pfnrasretrievebuffer(
HANDLE hPort,
PBYTE pBuffer,
PDWORD pdwSize
)
{...}
Parameter
hPort
Behandeln Sie den Port, an dem die Daten empfangen werden sollen. Bei diesem Handle sollte es sich um das Handle handeln, das von RAS als erster Parameter der RasCustomScriptExecute-Funktion übergeben wird.
pBuffer
Zeiger auf einen Puffer, um die Daten von dem durch den hPort-Parameter angegebenen Port zu empfangen. Rufen Sie diesen Puffer mithilfe der RasGetBuffer-Funktion ab. Der Wert dieses Parameters kann mit dem Zeiger auf den Puffer identisch sein, der an die RasReceiveBuffer-Funktion übergeben wird.
pdwSize
Zeiger auf eine DWORD-Variable , die die Größe der im Puffer zurückgegebenen Daten empfängt, auf die der pBuffer-Parameter verweist.
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 |
|---|---|
|
Der Zeiger auf den Puffer, der im pBuffer-Parameter übergeben wird, ist ungültig. |
|
Das vom hPort-Parameter angegebene Handle ist ungültig. |
RAS signalisiert das Ereignisobjekt, wenn der Port aus irgendeinem Grund getrennt wird, bevor die Daten veröffentlicht werden. In diesem Fall gibt RasRetrieveBuffer einen in Raserror.h definierten Fehler zurück, der die Ursache des Fehlers angibt.
Hinweise
Die RasRetrieveBuffer-Funktion ist synchron. Bei der Rückgabe enthält der Puffer, auf den der pBuffer-Parameter verweist, die Daten, die über den angegebenen Port empfangen werden. Die DLL für benutzerdefinierte Skripterstellung sollte RasRetrieveBuffer erst aufrufen, nachdem RAS das Ereignisobjekt signalisiert hat, das die DLL im Aufruf von RasReceiveBuffer übergeben hat.
Die DLL für benutzerdefinierte Skripterstellung ruft RasRetrieveBuffer über einen Funktionszeiger auf. Der Funktionszeiger wird als Parameter an die DLL für benutzerdefinierte Skripterstellung übergeben, wenn RAS die Implementierung von RasCustomScriptExecute der DLL aufruft.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | ras.h |