Platform SDK: RAS/Routing and RAS

RasFreeBuffer

The custom-scripting DLL calls RasFreeBuffer to release a memory buffer that was allocated by a previous call to RasGetBuffer.

typedef DWORD (APIENTRY *PFNFREEBUFFER) (
  PBYTE    pBuffer
);

Parameters

pBuffer
Pointer to the memory buffer to free. This memory must have been obtained by a previous call to RasGetBuffer.

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_BUFFER_INVALID The pointer to the buffer passed in the pBuffer parameter is invalid.
ERROR_INVALID_PORT_HANDLE The handle specified by the hPort parameter is invalid.

Remarks

The custom-scripting DLL calls RasFreeBuffer 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, RasGetBuffer