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

BSTR that specifies the lowest IP address in the IP address range.

ToIP

BSTR that specifies the highest IP address in the IP address range.

ExpirationDate

DATE value that specifies the expiration date and time of the 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 returns S_OK if the call is successful; otherwise, it returns an error code.

[Visual Basic]

Syntax

Function Add( _
  ByVal FromIP As String, _
  ByVal ToIP As String, _
  ByVal ExpirationDate As DATE, _
  ByRef pNewItem As FPCIpListRange _
) As FPCIpListRange

Parameters

FromIP

String that represents the lowest IP address of the IP address range.

ToIP

String that represents the highest IP address of the IP address range.

ExpirationDate

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

pNewItem

Reference that on return points to the new IFPCIpListRange object.

Return Value

If the call is unsuccessful, an error is raised that can be intercepted by using an error handler.

Remarks

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

FPCIpListRanges


Send comments about this topic to Microsoft

Build date: 11/30/2009

 

© 2008 Microsoft Corporation. All rights reserved.