CreateBuffer Method of the IFWXFirewall Interface

Article
08/13/2010

The CreateBuffer method creates (allocates) a buffer object of the given size.

Syntax

HRESULT CreateBuffer(
  [in]   DWORD dwBufferLength,
  [out]  IFWXIOBuffer** pIOBuffer
);

Parameters

dwBufferLength
Number of bytes to allocate.
pIOBuffer
Address of a variable that receives a pointer to the IFWXIOBuffer interface.

Return Value

This method returns S_OK if the call is successful; otherwise, it returns an error code.

Remarks

Use the CreateBuffer method to create an empty buffer for data that is not constant. To create a buffer for data that is constant, use the IFWXFirewall::CreateConstBuffer method.

Filters are not required to use this method. A filter may provide its own buffer objects as long as they support the IFWXIOBuffer interface.

Requirements

Server	Requires Windows Server 2008 R2 or Windows Server 2008 x64 Edition with SP2.
Version	Requires Forefront Threat Management Gateway (TMG) 2010.
Header	Declared in Wspfwext.idl.
DLL	Requires Wspsrv.exe.