Detach Method of the IFWXSessionFilter Interface

The Detach method detaches the session filter from its session. This method should release all references that the session filter object holds on the session and any related objects.

Syntax

HRESULT Detach();

Parameters

This method has no parameters.

Return Value

Implementations of this method should return the following:

S_OK

The method succeeded.

E_FAIL

The method failed. This will cause the Firewall service to generate an alert.

Example Code

The following is an example implementation of the Detach method.

HRESULT CMySessionFilter::Detach()
{
	// Assume that m_spSession is defined as CComPtr<IFWXSession>
	// and that IFWXSession::Release() is called 
	// by the assignment operator.
	Lock();
	m_spSession = NULL;
	Unlock();
 
	return S_OK;
}

Remarks

This method is typically called by the Microsoft Firewall service when the applicable session is about to be shut down.

Requirements

Server Requires Windows Server 2008.
Version Requires Forefront Threat Management Gateway (TMG).
Header

Declared in Wspfwext.idl.

See Also

IFWXSessionFilter


Send comments about this topic to Microsoft

Build date: 11/30/2009

© 2008 Microsoft Corporation. All rights reserved.