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
 ユーザーごとのサブスクリプションの所有者 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
ヘッダー eventsys.h

こちらもご覧ください

IMultiInterfacePublisherFilter

IPublisherFilter