Поделиться через

Метод IPublisherFilter::Initialize (eventsys.h)

  • Статья

Связывает метод события с коллекцией объектов подписки.

Этот метод поддерживается только для обеспечения обратной совместимости. В противном случае следует использовать методы интерфейса IMultiInterfacePublisherFilter .

Синтаксис

HRESULT Initialize(
  [in] BSTR      methodName,
  [in] IDispatch *dispUserDefined
);

Параметры

[in] methodName

Имя метода события, связанного с фильтром издателя.

[in] dispUserDefined

Указатель на интерфейс IEventSystem в объекте системы событий или интерфейс IEventControl в объекте класса событий.

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

Этот метод может возвращать стандартные возвращаемые значения E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED и E_FAIL, а также следующие значения.

Код возврата Описание
S_OK
 Фильтр издателя успешно инициализирован.
EVENT_S_SOME_SUBSCRIBERS_FAILED
 Событие удалось вызвать некоторые, но не все подписчики.
EVENT_E_ALL_SUBSCRIBERS_FAILED
 Событию не удалось вызвать ни одного из подписчиков.
EVENT_S_NOSUBSCRIBERS
 Событие было опубликовано, но подписчиков не было.
EVENT_E_QUERYSYNTAX
 При попытке вычисления строки запроса произошла синтаксическая ошибка.
EVENT_E_QUERYFIELD
 В строке запроса использовалось недопустимое имя поля.
EVENT_E_INTERNALEXCEPTION
 Возникло непредвиденное исключение.
EVENT_E_INTERNALERROR
 Обнаружена непредвиденная внутренняя ошибка.
EVENT_E_INVALID_PER_USER_SID
 Идентификатор безопасности владельца в подписке на пользователя не существует.
EVENT_E_USER_EXCEPTION
 Предоставленный пользователем компонент или подписчик вызвал исключение.
EVENT_E_TOO_MANY_METHODS
 Интерфейс имеет слишком много методов для запуска событий.
EVENT_E_MISSING_EVENTCLASS
 Подписку нельзя сохранить, если класс событий для подписки уже не существует.
EVENT_E_NOT_ALL_REMOVED
 Не все запрошенные объекты можно удалить.
EVENT_E_COMPLUS_NOT_INSTALLED
 Для этой операции требуется COM+, но он не установлен.

Комментарии

Фильтр издателя использует указатель, переданный в dispUserDefined, для получения списка подписчиков путем вызова IEventSystem::Query или IEventControl::GetSubscriptions.

Требования

   
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header eventsys.h

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

IMultiInterfacePublisherFilter

IPublisherFilter