[C++]

The Item method retrieves the requested IFPCAccount interface from the collection.

HRESULT Item(
  VARIANT Index,
  IFPCAccount** ppItem
);

Parameters

Index

[in] Required. Name or one-based index of the FPCAccount object to retrieve. The account name can be specified in the domain\user-name format.

ppItem

[out] Address of an interface pointer that on return points to the IFPCAccount interface requested.

Return Values

The method can return one of the following:

• S_OK, indicating that the operation succeeded.
• An error code indicating that the operation failed. In this case, the [out] parameter returned is a null object.

Remarks

The Index parameter can be either in the form of an index or a name. The domain\user-name format can be used to specify an account by name.

[Visual Basic]

The Item method retrieves the requested FPCAccount object from the collection.

Function Item( _
  ByVal Index As Variant _
) As FPCAccount

Parameters

Index

[in] Required. Name or one-based index of the FPCAccount object to retrieve. The account name can be specified in the domain\user-name format.

Return Values

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

Remarks

The Index parameter can be either in the form of an index or a name. For example, the following code specifies an account by name in domain\user-name format.

Dim accnts As FPCAccounts
...
accnts.Item("africa\john")