IFPCAdapters::_NewEnum property

Applies to: desktop apps only

The _NewEnum property gets an enumerator object for the collection. An enumerator object provides serial access to the elements of the collection.

This property is read-only.

Syntax

HRESULT get__NewEnum(
  IUnknown *ppEnum
);
' Data type: IUnknown

Property _NewEnum( _
  ByVal ppEnum As IUnknown _
) As IUnknown

Property value

Reference to an enumerator object that provides serial access to the elements of the collection.

Error codes

This property method returns S_OK if the call is successful; otherwise, it returns an error code.

Remarks

This property is read-only.

In Visual Basic and VBScript, this property is used implicitly in For Each...In...Next constructs.

In C++, when the Microsoft Forefront TMG Control service (isactrl) is stopped, calls to this property method complete successfully without retrieving any data for the adapters collection. This result should not be interpreted as an empty adapters collection.

Examples

This VBScript script displays a comma-delimited list of all IP addresses bound to each network adapter on the local Forefront TMG computer. It does not include error handling.

When the Microsoft Forefront TMG Control service (isactrl) is stopped, this script completes successfully without retrieving any data for the adapters collection. This result should not be interpreted as an empty adapters collection.

' Create the root object.
Dim root  ' The FPCLib.FPC root object
Set root = CreateObject("FPC.Root")
' Declare the other objects needed.
Dim server    ' An FPCServer object
Dim adapters  ' An FPCAdapters collection
Dim adapter   ' An FPCAdapter object
' Get references to the server object 
' and the adapters collection.
Set server = root.GetContainingServer()
Set adapters = server.Adapters
'Display the IP addresses bound to each network adapter.
For Each adapter In adapters
    WScript.Echo adapter.FriendlyName & ": " & adapter.IpAddresses 
Next

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

FPCAdapters

 

 

Build date: 7/12/2010