Funzione di callback PFNRASRETRIEVEBUFFER (ras.h)

  • Articolo

La DLL di scripting personalizzata chiama la funzione RasRetrieveBuffer per ottenere i dati ricevuti dal server RAS sulla porta specificata. La DLL di scripting personalizzata deve chiamare RasRetrieveBuffer solo dopo che RAS ha segnalato l'oggetto evento passato nella chiamata a RasReceiveBuffer.

Il tipo PFNRASRETRIEVEBUFFER definisce un puntatore a questa funzione di callback. RasRetrieveBuffer è un segnaposto per il nome della funzione definita dall'applicazione.

Sintassi

PFNRASRETRIEVEBUFFER Pfnrasretrievebuffer;

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

Parametri

hPort

Gestire la porta su cui ricevere i dati. Questo handle deve essere l'handle passato da RAS come primo parametro della funzione RasCustomScriptExecute .

pBuffer

Puntatore a un buffer per ricevere i dati dalla porta specificata dal parametro hPort . Ottenere questo buffer usando la funzione RasGetBuffer . Il valore di questo parametro può essere uguale al puntatore al buffer passato alla funzione RasReceiveBuffer .

pdwSize

Puntatore a una variabile DWORD che riceve le dimensioni dei dati restituiti nel buffer a cui fa riferimento il parametro pBuffer .

Valore restituito

Se la funzione ha esito positivo, il valore restituito è ERROR_SUCCESS.

Se la funzione ha esito negativo, il valore restituito può essere uno dei codici di errore seguenti.

Valore Significato
ERROR_BUFFER_INVALID
 Il puntatore al buffer passato nel parametro pBuffer non è valido.
ERROR_INVALID_PORT_HANDLE
 L'handle specificato dal parametro hPort non è valido.
 

RAS segnala l'oggetto evento se la porta viene disconnessa per qualche motivo prima della pubblicazione dei dati. In questo caso RasRetrieveBuffer restituisce un errore definito in Raserror.h, che indica la causa dell'errore.

Commenti

La funzione RasRetrieveBuffer è sincrona. Quando restituisce, il buffer a cui punta il parametro pBuffer contiene i dati ricevuti sulla porta specificata. La DLL di scripting personalizzata deve chiamare RasRetrieveBuffer solo dopo che RAS ha segnalato l'oggetto evento che la DLL passata nella chiamata a RasReceiveBuffer.

La DLL di scripting personalizzata chiama RasRetrieveBuffer tramite un puntatore alla funzione. Il puntatore alla funzione viene passato alla DLL di scripting personalizzata come parametro quando RAS chiama l'implementazione della DLL di RasCustomScriptExecute.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione ras.h

Vedi anche

Scripting personalizzato RAS

RasCustomScriptExecute

RasReceiveBuffer

RasSendBuffer