The Item method retrieves the requested IFPCNonWindowsUser interface from the collection. You can specify the interface either by its namespace and user name, or by its one-based index.

HRESULT Item(
  VARIANT IndexOrUsername,
  BSTR Namespace,
  IFPCNonWindowsUser** ppItem
);

Parameters

IndexOrUsername

[in] Required. One-based index or user name of the object to retrieve.

Namespace

[in, optional] BSTR that specifies the authentication namespace for the non-Windows user. This parameter must be specified when you provide a user name in the IndexOrUsername parameter. The default value is an empty BSTR.

ppItem

[out] Address of an interface pointer that on return points to the IFPCNonWindowsUser 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.

The Item method retrieves the requested FPCNonWindowsUser object from the collection. You can specify the object either by its namespace and user name, or by its one-based index.

Function Item( _
  ByVal IndexOrUsername As Variant, _
  [ ByVal Namespace As String ] _
) As FPCNonWindowsUser

Parameters

IndexOrUsername

[in] Required. One-based index or user name of the object to retrieve.

Namespace

[in, optional] String that specifies the authentication namespace for the non-Windows user. This parameter must be specified when you provide a user name in the IndexOrUsername parameter. The default value is an empty string.

Return Values

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