Microsoft Internet Security and Acceleration Server 2004 SDK

IFPCSessionsMonitor::Item[C++]

FPCSessionsMonitor.Item [Visual Basic]

[C++]

The Item method retrieves the requested IFPCSessionsMonitorEntry interface from the collection. This method returns only when the requested interface is found, the associated query ends, or an error occurs in the query.

HRESULT Item(
  long Index,
  IFPCSessionsMonitorEntry** ppItem
);

Parameters

Index
[in] Required. One-based index of the object to retrieve.
ppItem
[out] Address of an interface pointer that on return points to the IFPCSessionsMonitorEntry interface requested.

Return Values

The method can return one of the following: If the return value is not S_OK, the [out] parameter returned is a null object.

Remarks

This method can retrieve an IFPCSessionsMonitorEntry interface that represents an active session that exists when the query starts. If the interface requested is not found, the method waits until the associated query ends or an error occurs in the query.

[Visual Basic]

The Item method retrieves the requested FPCSessionsMonitorEntry object from the collection. This method returns only when the requested object is found, the associated query ends, or an error occurs in the query.

Function Item( _
  ByVal Index As Long _
) As FPCSessionsMonitorEntry

Parameters

Index
[in] Required. One-based index of the object to retrieve.

Return Values

This method returns a reference to the FPCSessionsMonitorEntry object requested if successful. Otherwise, an error is raised that can be intercepted by using an error handler.

Remarks

This method can retrieve an FPCSessionsMonitorEntry object that represents an active session that exists when the query starts. If the object requested is not found, the method waits until the associated query ends or an error occurs in the query.

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

FPCSessionsMonitor