IEnumUserIdentity::Next method

[IEnumUserIdentity::Next is not supported and may be altered or unavailable in the future. Instead, use User Accounts with Fast User Switching and Remote Desktop.]

Deprecated. Retrieves an array of user identity interfaces from the enumeration.

Syntax

HRESULT Next(
  [in]  ULONG    celt,
  [out] IUnknown **rgelt,
  [out] ULONG    *pceltFetched
);

celt [in]

Type: ULONG

A ULONG value that represents the number of interfaces to retrieve.

rgelt [out]

Type: IUnknown**

The address of a pointer that receives the interfaces.

pceltFetched [out]

Type: ULONG*

The address of a pointer that receives the number of interfaces successfully retrieved.

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

IEnumUserIdentity keeps an internal count that specifies which interface is next to be retrieved. Multiple calls to this method will not reset this count. To reset the count, call IEnumUserIdentity::Reset. To increment the count without retrieving interfaces, call IEnumUserIdentity::Skip.

The value of celt should not exceed the value returned by IEnumUserIdentity::GetCount.

Requirement	Value
Minimum supported client	Windows XP [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
End of client support	Windows XP
End of server support	Windows Server 2003
Header	Msident.h
IDL	Msident.idl
DLL	Msident.dll