ISyncProviderRegistration::GetChange method (syncregistration.h)

Gets an ISyncRegistrationChange object that represents a new registration event.


HRESULT GetChange(
  [in]  HANDLE                  hEvent,
  [out] ISyncRegistrationChange **ppChange


[in] hEvent

A HANDLE returned by the RegisterForEvent method.

[out] ppChange

The ISyncRegistrationChange object that contains the event, and the ID of the synchronization provider or synchronization provider configuration UI that has changed.

Return value

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

Return code Description
The method succeeded.
All outstanding events have been retrieved.
Invalid pointer.


This method resets the event that is passed in so that it will be set on a subsequent change in the registration store. In order to retrieve all events from the store, this method should be called until S_FALSE is returned and ppChange is NULL.

This method returns the changes that have occurred since RegisterForEvent or GetChange (whichever happened last) was last called for the given HANDLE. This means that if multiple changes are made to an item before GetChange can be called, these changes will be represented as a single change object returned from GetChange. In the case of an item being registered and unregistered between calls, no change will be returned.


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

See also

ISyncProviderRegistration Interface