IEnumSyncChangeUnits::Next method (winsync.h)

Returns the next change unit.

Syntax

HRESULT Next(
  [in]      ULONG           cChanges,
  [out]     ISyncChangeUnit **ppChangeUnit,
  [in, out] ULONG           *pcFetched
);

Parameters

[in] cChanges

The number of change units to fetch. The only valid value is 1.

[out] ppChangeUnit

Returns the next change unit object.

[in, out] pcFetched

Returns the number of change units that are fetched.

Return value

The possible return codes include, but are not limited to, the values shown in the following table.

Return code	Description
S_OK	The method succeeded.
S_FALSE
E_POINTER

Remarks

This method currently only supports retrieval of a single change unit. Therefore, cChanges must be 1. Otherwise, the call will fail.

Requirements

Requirement	Value
Minimum supported client	Windows 7 [desktop apps only]
Minimum supported server	Windows Server 2008 R2 [desktop apps only]
Target Platform	Windows
Header	winsync.h

See also

IEnumSyncChangeUnits Interface