PFNRASFREEBUFFER callback function (ras.h)

Article
02/22/2024

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

Syntax

PFNRASFREEBUFFER Pfnrasfreebuffer;

DWORD Pfnrasfreebuffer(
  PBYTE pBufer
)
{...}

Parameters

pBufer

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.

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

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Target Platform	Windows
Header	ras.h