Platform SDK: RAS/Routing and RAS

RasGetBuffer

The custom-scripting DLL calls RasGetBuffer to allocate memory for sending or receiving data over the port connected to the server.

typedef DWORD (APIENTRY *PFNRASGETBUFFER) (
  PBYTE *   ppBuffer,
  PDWORD    pdwSize
);

Parameters

ppBuffer
Pointer to a pointer that receives the address of the returned buffer.
pdwSize
Pointer to a DWORD variable that, on input, contains the requested size of the buffer. On output, this variable contains the actual size of the buffer allocated.

Return values

If the function succeeds, the return value is ERROR_SUCCESS.

If the function fails, the return value can be one of the following error codes.

Value Meaning
ERROR_OUT_OF_BUFFERS RAS cannot allocate anymore buffer space.

Remarks

The maximum buffer size that can be obtained from is 1500 bytes.

The custom-scripting DLL calls RasGetBuffer through a function pointer. The function pointer is passed to the custom-scripting DLL as a parameter when RAS calls the DLL's implementation of RasCustomScriptExecute.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Unsupported.
  Header: Declared in Rasdlg.h.

See Also

RAS Custom-Scripting, RasCustomScriptExecute, RasFreeBuffer