Microsoft Internet Security and Acceleration Server 2004 SDK

IFWXSocket::Recv

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

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

Parameters

pIOBuffer
[in] 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
[in] Pointer to the IFWXIOCompletion interface that receives the completion notification. This parameter is required. it cannot be NULL.
UserData
[in] An opaque value to pass to the IFWXIOCompletion::CompleteAsyncIO notification method. This parameter provides a context to the notification.

Return Values

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

Requirements

Server: Requires Windows Server 2003 or Windows 2000.
Version: Requires Internet Security and Acceleration Server 2004.
Header: Declared in Wspfwext.idl.

See Also

IFWXSocket