Item Method of the IFPCNonWindowsUsers Interface

Syntax

HRESULT Item(
  [in]			VARIANT IndexOrUsername,
  [in, optional]  BSTR Namespace,
  [out]		 IFPCNonWindowsUser** pItem
);

Parameters

IndexOrUsername

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

Namespace

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.

pItem

Address of an interface pointer that on return points to the IFPCNonWindowsUser interface requested.

Return Value

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.

Syntax

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

Parameters

IndexOrUsername

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

Namespace

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 Value

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.