Метод 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