Метод ISyncProviderRegistration::GetChange (syncregistration.h)

  • Статья

Возвращает объект ISyncRegistrationChange , представляющий новое событие регистрации.

Синтаксис

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

Параметры

[in] hEvent

HANDLE, возвращаемый методом RegisterForEvent.

[out] ppChange

Объект ISyncRegistrationChange , содержащий событие, и идентификатор измененного поставщика синхронизации или пользовательского интерфейса конфигурации поставщика синхронизации.

Возвращаемое значение

Возможные коды возврата включают, помимо прочего, значения, показанные в следующей таблице.

Код возврата Описание
S_OK
 Метод выполнен успешно.
S_FALSE
 Получены все выдающиеся события.
E_POINTER
 Недопустимый указатель.

Комментарии

Этот метод сбрасывает переданное событие, чтобы оно было задано при последующем изменении в хранилище регистрации. Чтобы получить все события из хранилища, этот метод должен вызываться до тех пор, пока не будет возвращено S_FALSE , а значение ppChange равно NULL.

Этот метод возвращает изменения, произошедшие с момента последнего вызова RegisterForEvent или GetChange (в зависимости от того, что произошло в последний раз) для данного HANDLE. Это означает, что при внесении нескольких изменений в элемент до вызова GetChange эти изменения будут представлены в виде одного объекта изменения, возвращаемого из GetChange. В случае регистрации и отмены регистрации элемента между вызовами изменения не будут возвращены.

Требования

Требование Значение
Минимальная версия клиента Windows 7 [только классические приложения]
Минимальная версия сервера Windows Server 2008 R2 [только классические приложения]
Целевая платформа Windows
Header syncregistration.h

См. также раздел

Интерфейс ISyncProviderRegistration