ISyncProviderRegistration::GetChange-Methode (syncregistration.h)

Ruft ein ISyncRegistrationChange-Objekt ab, das ein neues Registrierungsereignis darstellt.

Syntax

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

Parameter

[in] hEvent

Ein HANDLE, der von der RegisterForEvent-Methode zurückgegeben wird.

[out] ppChange

Das ISyncRegistrationChange-Objekt , das das Ereignis enthält, und die ID der geänderten Benutzeroberfläche des Synchronisierungsanbieters oder des Synchronisierungsanbieters.

Rückgabewert

Zu den möglichen Rückgabecodes gehören die werte in der folgenden Tabelle, sind aber nicht darauf beschränkt.

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich ausgeführt.
S_FALSE	Alle herausragenden Ereignisse wurden abgerufen.
E_POINTER	Der Zeiger ist ungültig.

Bemerkungen

Diese Methode setzt das übergebene Ereignis zurück, sodass es bei einer späteren Änderung im Registrierungsspeicher festgelegt wird. Um alle Ereignisse aus dem Speicher abzurufen, sollte diese Methode aufgerufen werden, bis S_FALSE zurückgegeben wird und ppChangeNULL ist.

Diese Methode gibt die Änderungen zurück, die aufgetreten sind, seit RegisterForEvent oder GetChange (je nachdem, was zuletzt passiert ist) für den angegebenen HANDLE aufgerufen wurde. Wenn also mehrere Änderungen an einem Element vorgenommen werden, bevor GetChange aufgerufen werden kann, werden diese Änderungen als einzelnes Änderungsobjekt dargestellt, das von GetChange zurückgegeben wird. Im Fall, dass ein Element zwischen Aufrufen registriert und nicht registriert wird, wird keine Änderung zurückgegeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	syncregistration.h

Weitere Informationen

ISyncProviderRegistration-Schnittstelle