Item Method of the IFPCNonWindowsUsers Interface

The Item method retrieves the requested FPCNonWindowsUser object (IFPCNonWindowsUser interface in C++) from the collection. You can specify the object either by its namespace and user name, or by its one-based index.

[C++]

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:

[Visual Basic]

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.

Requirements

Client Requires Windows Vista or Windows XP.
Server Requires Windows Server 2008.
Version Requires Forefront Threat Management Gateway (TMG).
IDL

Declared in Msfpccom.idl.

DLL

Requires Msfpccom.dll.

See Also

FPCNonWindowsUsers


Send comments about this topic to Microsoft

Build date: 11/30/2009

© 2008 Microsoft Corporation. All rights reserved.

[an error occurred while processing this directive]