Add Method of the IFPCIpListRanges Interface

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

C++

Syntax

HRESULT Add(
  [in]   BSTR FromIP,
  [in]   BSTR ToIP,
  [in]   DATE ExpirationDate,
  [out]  IFPCIpListRange** ppNewItem
);

Parameters

• FromIP
  Required. BSTR that specifies the lowest IP address in new the IP address range.

• ToIP
  Required. BSTR that specifies the highest IP address in the new IP address range.

• ExpirationDate
  Required. DATE value that specifies the expiration date and time of the new IP list range in Coordinated Universal Time (UTC).

• ppNewItem
  Address of an interface pointer that on return points to the new IFPCIpListRange 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 FromIP As String, _
  ByVal ToIP As String, _
  ByVal ExpirationDate As Date _
) As FPCIpListRange

Parameters

• FromIP
  Required. String that specifies the lowest IP address of the new IP address range.

• ToIP
  Required. String that specifies the highest IP address of the new IP address range.

• ExpirationDate
  Required. Date value that specifies the expiration date and time of the new IP list range in Coordinated Universal Time (UTC).

Return Value

This method returns a reference to the FPCIpListRange object created 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

FPCIpListRanges

Send comments about this topic to Microsoft

Build date: 6/30/2010