IEnumSyncItems::Next method

  • Article

[The IEnumSyncItems interface is available for use through Windows XP. It is not available in subsequent versions of Windows.]

Retrieves an array of one or more items from the enumeration, represented by SYNC_HANDLER_ITEM_INFO structures.

Syntax

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

Parameters

  • celt [in]
    Type: ULONG

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

  • rgelt [out]
    Type: LPSYNC_HANDLER_ITEM_INFO

    A pointer to the first structure in the array.

  • pceltFetched [out]
    Type: ULONG*

    A pointer to the number of structures successfully retrieved.

Return value

Type: HRESULT

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

Remarks

IEnumSyncItems 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 IEnumSyncItems::Reset. To increment the count without retrieving interfaces, call IEnumSyncItems::Skip.

Requirements

Minimum supported client

Windows 2000 Professional [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

 Syncmgr.h

IDL

 Syncmgr.idl

DLL

 Mobsync.dll