_NewEnum Property of the IFPCAdapters Interface

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

[C++]
HRESULT get__NewEnum(
	IUnknown* ppEnum
);

Parameters

ppEnum

Address of an interface pointer that on return points to the IUnknown interface of an enumerator object that implements an IEnumVARIANT interface for the collection. An interface pointer to the IEnumVARIANT interface of the enumerator object can be retrieved by calling QueryInterface on the IUnknown interface returned.

Return Value

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

[Visual Basic]
Property _NewEnum As IUnknown

Property Value

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

Example Code

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.
' 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

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.

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.

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

FPCAdapters


Send comments about this topic to Microsoft

Build date: 11/30/2009

© 2008 Microsoft Corporation. All rights reserved.