_NewEnum Property of the IFPCConnectivityVerifiers 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 the names of all the connectivity verifiers defined for an FPCArray object and the IP addresses and TCP ports on remote servers with which they check connectivity. This example 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 isaArray			 ' An FPCArray object
Dim connectivityVerifiers  ' An FPCConnectivityVerifiers collection
Dim connectivityVerifier   ' An FPCConnectivityVerifier object
' Get references to the array object 
' and the connectivity verifiers collection.
Set isaArray = root.GetContainingArray()
Set connectivityVerifiers = isaArray.ConnectivityVerifiers
' Display the names of the connectivity verifiers defined
' for the array object and the IP addresses and TCP ports
' on remote servers with which they check connectivity.
For Each connectivityVerifier In connectivityVerifiers
	WScript.Echo "Connectivity verifier name: " & connectivityVerifier.Name & vbCrLf & _
				 "IP address and TCP port: " & connectivityVerifier.ServerAddress & ":" & _
				 connectivityVerifier.TCPPort
Next

Remarks

This property is read-only.

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

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.