IFWXDataFilter::SetSockets Method

Sets the internal and external sockets for the data filter. When this function is called, the filter is expected to begin the data-pumping process between the sockets.

HRESULT SetSockets(
  IFWXSocket *piInternalSocket,
  IFWXSocket *pIExternalSocket,
  IFWXConnection *piConnection,
  IUnknown *punkFilterContext
);

Parameters

piInternalSocket

[in] Pointer to the IFWXSocket interface for an internal socket.

pIExternalSocket

[in] Pointer to the IFWXSocket interface for an external socket.

piConnection

[in] Pointer to the IFWXConnection interface on the connection object on which this data filter is installed.

punkFilterContext

[in] Pointer to the interface used to pass context information to the data filter. The parameter will have the same value as the punkFilterContext parameter of IFWXConnection::AttachDataFilter and IFWXSession::SetDataFilterFactory.

Return Values

S_OK

The method succeeded.

E_OUTOFMEMORY

Insufficient memory or resources to process the event. The connection will be terminated.

Remarks

A filter that is emulating a connection receives NULL for the external socket interface.