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

Статья
08/23/2023

Подготавливает фильтр издателя для запуска отфильтрованного списка подписок с помощью предоставленного элемента управления срабатыванием. Элемент управления срабатыванием содержится в объекте класса событий.

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

Синтаксис

HRESULT PrepareToFire(
  [in] BSTR           methodName,
  [in] IFiringControl *firingControl
);

Параметры

[in] methodName

Имя запускаемого метода события.

[in] firingControl

Указатель на интерфейс IFiringControl на объекте управления срабатыванием.

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

Этот метод может возвращать стандартные возвращаемые значения 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+, но он не установлен.

Требования

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

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

IMultiInterfacePublisherFilter

IPublisherFilter

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