RasFreeBuffer callback function

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

Syntax


DWORD CALLBACK RasFreeBuffer(
   PBYTE pBuffer
);

Parameters

pBuffer

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

Return value

If the function succeeds, the return value is ERROR_SUCCESS.

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

ValueMeaning
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

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
RasGetBuffer

 

 

Show: