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

  • Статья
  • Чтение занимает 2 мин

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

Синтаксис

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

Параметры

[in] hEvent

ДЕСКРИПТОР, возвращаемый методом 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