Microsoft Internet Security and Acceleration Server 2004 SDK

_NewEnum Property of IFPCConnectivityResults[C++]

FPCConnectivityResults._NewEnum [Visual Basic]

[C++]

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

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 Values

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

Remarks

This property is read-only.

[Visual Basic]

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

Property _NewEnum As IUnknown

Property Value

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

Remarks

This property is read-only.

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

Example Code

This VBScript script displays the IP addresses and ports on remote servers with which the local ISA Server computer attempted to verify 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 server			 ' An FPCServer object
Dim connectivityresults  ' An FPCConnectivityResults collection
Dim connectivityresult   ' An FPCConnectivityResult object

' Get references to the server object 
' and the connectivity results collection.
Set server = root.GetContainingServer()
Set connectivityresults = server.ConnectivityResults

' Display the IP addresses and TCP ports on remote servers with which attempts
' were made to verify connectivity.
For Each connectivityresult In connectivityresults
	WScript.Echo "IP address and TCP port: " & connectivityresult.ServerAddress & _
				 ":" & connectivityresult.TCPPort 
Next

Requirements

Server: Requires Windows Server 2003 or Windows 2000.
Version: Requires Internet Security and Acceleration Server 2004.
Header: Declared in Msfpccom.idl.
Library: Use Microsoft Internet Security and Acceleration Server 2004 Administration Library.

See Also

FPCConnectivityResults