RasGetBuffer callback function

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

Syntax


DWORD CALLBACK RasGetBuffer(
  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 value

If the function succeeds, the return value is ERROR_SUCCESS.

If the function fails, the return value is the following error code.

ValueMeaning
ERROR_OUT_OF_BUFFERS

RAS cannot allocate anymore buffer space.

 

Remarks

The maximum buffer size that can be obtained 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

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Ras.h

See also

RAS Custom-Scripting
RasCustomScriptExecute
RasFreeBuffer

 

 

Community Additions

ADD
Show:
© 2014 Microsoft