Item Method of the IFPCIpRangeSet Interface

The Item method retrieves the FPCIpRangeEntry object specified by its index or by the upper and lower bounds of its IP address range (IFPCIpRangeEntry interface in C++) from the collection.

C++

Syntax

HRESULT Item(
  [in]            VARIANT IndexOrIP_From,
  [in, optional]  BSTR IP_To,
  [out]           IFPCIpRangeEntry** pItem
);

Parameters

  • IndexOrIP_From
    Required. One-based index or lower bound of the IP address range of the object to retrieve.

  • IP_To
    Upper bound of the IP address range of the object to retrieve. This parameter must be specified if the IndexOrIP_From parameter is set to the lower bound of an IP address range. The default value is NULL.

  • pItem
    Address of an interface pointer that on return points to the IFPCIpRangeEntry interface requested.

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 Item( _
  ByVal IndexOrIP_From As Variant, _
  [ ByVal IP_To As String ] _
) As FPCIpRangeEntry

Parameters

  • IndexOrIP_From
    Required. One-based index or lower bound of the IP address range of the object to retrieve.

  • IP_To
    Upper bound of the IP address range of the object to retrieve. This parameter must be specified if the IndexOrIP_From parameter is set to the lower bound of an IP address range. The default value is NULL.

Return Value

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

FPCIpRangeSet

Send comments about this topic to Microsoft

Build date: 6/30/2010