Add Method of the IFPCAddressRanges Interface

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

C++

Syntax

HRESULT Add(
  [in]   BSTR Name,
  [in]   BSTR IP_From,
  [in]   BSTR IP_To,
  [out]  IFPCAddressRange** ppNewItem
);

Parameters

• Name
  Required. BSTR that specifies the name of the IP address range.

• IP_From
  Required. BSTR that specifies the lower bound of the IP address range.

• IP_To
  Required. BSTR that specifies the upper bound of the IP address range.

• ppNewItem
  Address of an interface pointer that on return points to the new IFPCAddressRange interface created.

Return Value

This method can return one of the following:

• S_OK, indicating that the operation succeeded.
• An error code, indicating that the operation failed. In this case, the [out] parameter returned is a null object.

Visual Basic

Syntax

Function Add( _
  ByVal Name As String, _
  ByVal IP_From As String, _
  ByVal IP_To As String _
) As FPCAddressRange

Parameters

• Name
  Required. String that specifies the name of the IP address range.
• IP_From
  Required. String that specifies the lower bound of the IP address range.
• IP_To
  Required. String that specifies the upper bound of the IP address range.

Return Value

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

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

FPCAddressRanges

Send comments about this topic to Microsoft

Build date: 6/30/2010