IFPCIpListRanges::Add method

  • Article

Applies to: desktop apps only

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

Syntax

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

FPCIpListRanges.Add( _
  ByVal FromIP As BSTR, _
  ByVal FromIP As String, _
  ByVal ToIP As BSTR, _
  ByVal ToIP As String, _
  ByVal ExpirationDate As DATE, _
  ByVal ExpirationDate As Date, _
  ByRef ppNewItem As IFPCIpListRange _
) As FPCIpListRange

Parameters

  • FromIP [in]

    C++

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

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

  • ToIP [in]

    C++

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

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

  • ExpirationDate [in]

    C++

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

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

  • ppNewItem [out]
    Address of an interface pointer that on return points to the new IFPCIpListRange interface created.

Return value

C++

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.

VB

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

Minimum supported client

 Windows Vista

Minimum supported server

 Windows Server 2008 R2, Windows Server 2008 with SP2 (64-bit only)

Version

 Forefront Threat Management Gateway (TMG) 2010

IDL

 Msfpccom.idl

DLL

 Msfpccom.dll

See also

FPCIpListRanges

 

 

Build date: 7/12/2010