Recv Method of the IFWXSocket Interface

The Receive method receives a buffer asynchronously. It performs an overlapped receive (or receive from operation, depending on the socket type).

Syntax

HRESULT Recv(
  [in]  IFWXIOBuffer* pIOBuffer,
  [in]  IFWXIOCompletion* pIFWXIOCompletion,
  [in]  UserContextType UserData
);

Parameters

  • pIOBuffer
    Pointer to the buffer that receives the data.

    This parameter may be set to NULL, so that the Microsoft Firewall service will create the buffer. In this case, the same buffer object can be passed between data filters, and buffer copy will be avoided. The IFWXIOCompletion::CompleteAsyncIO completion method receives a buffer object as one of its arguments.

  • pIFWXIOCompletion
    Pointer to the IFWXIOCompletion interface that receives the completion notification. This parameter is required. it cannot be NULL.

  • UserData
    An opaque value to pass to the IFWXIOCompletion::CompleteAsyncIO notification method. This parameter provides a context to the notification.

Return Value

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

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.

See Also

IFWXSocket

Send comments about this topic to Microsoft

Build date: 6/30/2010