Microsoft Internet Security and Acceleration Server 2004 SDK

IFPCWebFilters::Add[C++]

FPCWebFilters.Add [Visual Basic]

[C++]

The Add method creates a new FPCWebFilter object in the collection and returns a reference to it.

HRESULT Add(
  BSTR Guid,
  BSTR Name,
  BSTR RelativePath,
  FpcFilterPriority Priority,
  FpcFilterDirection Direction,
  IFPCWebFilter** ppNewFilter
);

Parameters

Guid
[in] Required. String that specifies the GUID of the new filter.
Name
[in] Required. String that specifies the display name of the new filter.
RelativePath
[in] Required. String that specifies the path of the filter's DLL relative to the ISA Server installation folder (such as C:\Program Files\Microsoft ISA Server\).
Priority
[in] Value from the FpcFilterPriority enumerated type that specifies the priority of the new filter. The possible values are fpcFilterPriority_Low, fpcFilterPriority_Medium, or fpcFilterPriority_High.
Direction
[in] Value from the FpcFilterDirection enumerated type that specifies whether the new filter operates in the forward proxy mode, in the reverse proxy mode, or in both modes.
ppNewFilter
[out] Address of an interface pointer that on return points to the new IFPCWebFilter interface created.

Return Values

This method can return one of the following:
[Visual Basic]

The Add method creates a new FPCWebFilter object in the collection and returns a reference to it.

Function Add( _
  ByVal Guid As String, _
  ByVal Name As String, _
  ByVal RelativePath As String, _
  ByVal Priority As FpcFilterPriority, _
  ByVal Direction As FpcFilterDirection _
) As FPCWebFilter

Parameters

Guid
[in] Required. String that specifies the GUID of the new filter.
Name
[in] Required. String that specifies the display name of the new filter.
RelativePath
[in] Required. String that specifies the path of the filter's DLL relative to the ISA Server installation folder (such as C:\Program Files\Microsoft ISA Server\).
Priority
[in] Value from the FpcFilterPriority enumerated type that specifies the priority of the new filter. The possible values are fpcFilterPriority_Low, fpcFilterPriority_Medium, or fpcFilterPriority_High.
Direction
[in] Value from the FpcFilterDirection enumerated type that specifies whether the new filter operates in the forward proxy mode, in the reverse proxy mode, or in both modes.

Return Values

This method returns a reference to an FPCWebFilter object if successful. Otherwise, an error is raised that can be intercepted by using an error handler.

Requirements

Server: Requires Windows Server 2003 or Windows 2000.
Version: Requires Internet Security and Acceleration Server 2004.
Header: Declared in Msfpccom.idl.
Library: Use Microsoft Internet Security and Acceleration Server 2004 Administration Library.

See Also

FPCWebFilters