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

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

Синтаксис

HRESULT RegisterForEvent(
  [out] HANDLE *phEvent
);

Параметры

[out] phEvent

Handle to событие синхронизации, которое используется для уведомления вызывающей стороны о поступлении новых событий регистрации.

Примечание Вызывающий объект не должен закрывать возвращенный HANDLE. Хранилище регистрации будет управлять памятью для HANDLE и закроет ее при отмене события путем передачи HANDLE в RevokeEvent или до освобождения объекта хранилища из памяти.

 

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

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

Код возврата	Описание
S_OK	Метод выполнен успешно.
E_POINTER	Недопустимый указатель.

Комментарии

Метод HANDLE, возвращаемый этим методом, используется методом GetChange. Событие будет задано только один раз из вызова RegisterForEvent . Все последующие уведомления будут появляться только в том случае, если пользователь вызывает метод GetChange .

Чтобы отменить регистрацию в этой системе уведомлений о событиях, вызовите метод RevokeEvent .

Требования

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

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

Интерфейс ISyncProviderRegistration