Funzione di callback PFNRASGETBUFFER (ras.h)

La DLL di scripting personalizzata chiama RasGetBuffer per allocare memoria per l'invio o la ricezione di dati sulla porta connessa al server.

Sintassi

PFNRASGETBUFFER Pfnrasgetbuffer;

DWORD Pfnrasgetbuffer(
  PBYTE *ppBuffer,
  PDWORD pdwSize
)
{...}

Parametri

ppBuffer

Puntatore a un puntatore che riceve l'indirizzo del buffer restituito.

pdwSize

Puntatore a una variabile DWORD che, all'input, contiene le dimensioni richieste del buffer. Nell'output questa variabile contiene le dimensioni effettive del buffer allocato.

Valore restituito

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

Se la funzione ha esito negativo, il valore restituito è il codice di errore seguente.

Valore	Significato
ERROR_OUT_OF_BUFFERS	RAS non può allocare più spazio buffer.

Commenti

La dimensione massima del buffer che può essere ottenuta è di 1500 byte.

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

Requisiti

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

RasFreeBuffer