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


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

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

Этот метод поддерживается только для обеспечения обратной совместимости. В противном случае следует использовать методы интерфейса 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