Метод ISyncProviderRegistration::GetChange (syncregistration.h)
Возвращает объект ISyncRegistrationChange , представляющий новое событие регистрации.
Синтаксис
HRESULT GetChange(
[in] HANDLE hEvent,
[out] ISyncRegistrationChange **ppChange
);
Параметры
[in] hEvent
ДЕСКРИПТОР, возвращаемый методом RegisterForEvent.
[out] ppChange
Объект ISyncRegistrationChange , содержащий событие, и идентификатор поставщика синхронизации или измененный пользовательский интерфейс конфигурации поставщика синхронизации.
Возвращаемое значение
Возможные коды возврата включают, но не ограничиваются значениями, приведенными в следующей таблице.
Код возврата | Описание |
---|---|
|
Метод выполнен успешно. |
|
Получены все необработанные события. |
|
Недопустимый указатель. |
Комментарии
Этот метод сбрасывает переданное событие, чтобы оно было задано при последующем изменении в хранилище регистрации. Чтобы получить все события из хранилища, этот метод должен вызываться до тех пор, пока не будет возвращен S_FALSE , а ppChange имеет значение NULL.
Этот метод возвращает изменения, произошедшие с момента последнего вызова RegisterForEvent или GetChange (в зависимости от последнего), для данного HANDLE. Это означает, что если несколько изменений вносятся в элемент до вызова GetChange , эти изменения будут представлены в виде одного объекта изменения, возвращаемого из GetChange. В случае регистрации и отмены регистрации элемента между вызовами изменения не будут возвращены.
Требования
Минимальная версия клиента | Windows 7 [только классические приложения] |
Минимальная версия сервера | Windows Server 2008 R2 [только классические приложения] |
Целевая платформа | Windows |
Header | syncregistration.h |