Share via

Remove Method of the IFPCExplicitLinkTranslationMappings Interface

  • Article

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 7 or Windows Vista.
Server Requires Windows Server 2008 R2 or Windows Server 2008 x64 Edition with SP2.
Version Requires Forefront Threat Management Gateway (TMG) 2010.
IDL

Declared in Msfpccom.idl.
DLL

Requires Msfpccom.dll.

See Also

FPCExplicitLinkTranslationMappings

Send comments about this topic to Microsoft

Build date: 6/30/2010