IEventSubscription::P utSubscriberProperty メソッド (eventsys.h)

サブスクライバー コンテキストを定義するために、プロパティとその値をプロパティ バッグに書き込みます。

構文

HRESULT PutSubscriberProperty(
  [in] BSTR    bstrPropertyName,
  [in] VARIANT *propertyValue
);

パラメーター

[in] bstrPropertyName

プロパティ バッグに値を書き込むプロパティの名前。 プロパティがプロパティ バッグに含まれていない場合、このメソッドはそれを追加します。

[in] propertyValue

プロパティ バッグに書き込まれるプロパティの値。 プロパティが既にプロパティ バッグ内にある場合、このメソッドは現在の値を上書きします。

戻り値

このメソッドは、E_INVALIDARG、E_OUTOFMEMORY、E_UNEXPECTED、E_FAIL、S_OKの標準戻り値を返すことができます。

解説

プロパティ バッグは、サブスクライバーに通知する必要があるイベントに関する情報を格納するために使用されます。 たとえば、スポーツ ティッカーのサブスクライバーが野球のスコアのみを取得する場合、サブスクリプション オブジェクトのプロパティ バッグを使用してこの制限を指定できます。

要件

サポートされている最小のクライアント	Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	eventsys.h

関連項目

IEventSubscription

SubscriberCLSID