IFWXConnection::EmulateForConnect

The EmulateForConnect method emulates a connection for an outbound request. In the outbound scenario, a data filter emulates the external connection for an internal client.

HRESULT EmulateForConnect(
  IFWXDataFilter* piDataFilter,
  IUnknown* punkFilterContext
);

Parameters

piDataFilter

[in] Pointer to the IFWXDataFilter interface of the Microsoft Firewall service data filter object to use with this connection.

punkFilterContext

[in] Pointer to the interface to use to pass contextual information to the data filter, such as the session to which the data filter is being attached. This interface is passed to the IFWXDataFilter::SetSockets method in the punkFilterContext parameter. This parameter can be NULL.

Return Values

S_OK

The method succeeded.

E_OUTOFMEMORY

Insufficient memory or resources; the method failed.

FWX_E_TERMINATING

The object is shutting down.

E_INVALIDARG

Invalid value was passed to the method.

FWX_E_ALREADY_EMULATED

The connection is already being emulated (cannot emulate the same connection twice).

FWX_E_BAD_CONTEXT

This method is only valid in the context of certain events. It cannot be used at other times.

Requirements

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

See Also

IFWXConnection