MoveDown Method of the IFPCWebFilters Interface

The MoveDown method moves the specified filter one step down the list of filters.

[C++]

Syntax

HRESULT MoveDown(
  [in]  long Index
);

Parameters

Index

Required. Index (the current position indicated by the Order property) of the filter to move down.

Return Value

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

Syntax

Sub MoveDown( _
  ByVal Index As Long _
)

Parameters

Index

Required. Index (the current position indicated by the Order property) of the filter to move down.

Return Value

This method has no return values. If the call is unsuccessful, an error is raised that can be intercepted by using an error handler.

Example Code

This VBScript script moves the first Web filter in the FPCWebFilters collection for the containing array one step down the list of Web filters, causing this Web filter to become the second Web filter to be called among the Web filters with the same priority. It does not include error handling. 
' Create the root object.
Dim root  ' The FPCLib.FPC root object
Set root = CreateObject("FPC.Root")
' Declare the other objects needed.
Dim tmgArray  ' An FPCArray object
Dim filters   ' An FPCWebFilters collection
' Get references to the array object 
' and the Web filters collection.
Set tmgArray = root.GetContainingArray()
Set filters = tmgArray.Extensions.WebFilters
' Move the first Web filter in the collection
' one step down the list of Web filters.
If filters.Count > 1 Then
	filters.MoveDown  1
	filters.Save
	WScript.Echo "Done!"
Else
	WSCript.Echo "Two or more Web filters are needed."
End If

Remarks

This method can be used to move a Web filter only into the positions of Web filters that have the same priority.

The MoveDown method is applicable only to the FPCWebFilters collection in an array configuration. The FPCWebFilters collection in the enterprise configuration is not ordered, and this method is disabled in it.

Requirements

Client Requires Windows Vista or Windows XP.
Server Requires Windows Server 2008.
Version Requires Forefront Threat Management Gateway (TMG).
IDL

Declared in Msfpccom.idl.
DLL

Requires Msfpccom.dll.

See Also

FPCWebFilters
MoveUp


Send comments about this topic to Microsoft

Build date: 11/30/2009

 

© 2008 Microsoft Corporation. All rights reserved.