Remove Method of the IFPCExplicitLinkTranslationMappings Interface

The Remove method removes the specified FPCExplicitLinkTranslationMapping object from the collection.

[C++]

Syntax

HRESULT Remove(
  [in]  VARIANT Index
);

Parameters

Index

Required. One-based index of the FPCExplicitLinkTranslationMapping object to remove.

Return Value

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

[Visual Basic]

Syntax

Sub Remove( _
  ByVal Index As Variant _
)

Parameters

Index

Required. One-based index of the FPCExplicitLinkTranslationMapping object to remove.

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 removes all the user-defined (explicit) global link translation mappings for the local array. 
Option Explicit
ClearGlobalMappings
Sub ClearGlobalMappings()
	' Create the root object.
	Dim root  ' The FPCLib.FPC root object
	Set root = CreateObject("FPC.Root")
	'Declare the other objects needed.
	Dim isaArray	' An FPCArray object
	Dim mappings	' An FPCExplicitLinkTranslationMappings collection
	' Get references to the array object and the collection of user-defined
	' global mappings.
	Set isaArray = root.GetContainingArray()
	Set mappings = isaArray.ArrayPolicy.WebProxy.ExplicitLinkTranslationMappings
	' Clear the existing user-defined global mappings for the array.
	WScript.Echo "Removing the existing user-defined global mappings..." 
	i = mappings.Count
	Do While i > 0
		mappings.Remove i
		i = i - 1	 
	Loop
	isaArray.Save True
	WScript.Echo "Done!"
End Sub

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

FPCExplicitLinkTranslationMappings


Send comments about this topic to Microsoft

Build date: 11/30/2009

 

© 2008 Microsoft Corporation. All rights reserved.