PROP_ENTRY_INTERFACE_CALLBACK_EX

[アーティクル]
08/09/2011

オブジェクトが複数のディスパッチインターフェイスをサポートする場合に、特定の IID を指定できます。 PROP_ENTRY_INTERFACE_CALLBACK に似ています。

PROP_ENTRY_INTERFACE_CALLBACK_EX(
   szDesc,
   dispid,
   clsid,
   iidDispatch,
   pfnFunc,
   vt
)

パラメーター

[入力] szDesc
プロパティの説明。
[入力] dispid
プロパティの DISPID。
[入力] clsid
関連付けられたプロパティページの CLSID。関連付けられたプロパティページを持たないプロパティの場合には、特別な値 CLSID_NULL を使用します。
[入力] iidDispatch
プロパティを定義するディスパッチインターフェイスの IID。
[入力] pfnFunc
読み込み処理中にデータを制御するコールバック関数。
[入力] vt
プロパティの型。

解説

このマクロを含めることで、アプリケーションが IPersistStreamInitImpl::Load プロセスをより詳細に制御できるようにします。コールバック関数 pfnFunc は、IPersistStreamInitImpl::Load が信頼されていないストリームからデータを取得するときに呼び出されます。このコールバック関数はデータをフィルター処理し、どのオブジェクトを読み込むかを制御します。

このマクロは、IPersistStreamInitImpl が基本クラスであり、そのクラスが初期化しても問題がないとアドバタイズされている場合にのみ適用されます。それ以外の場合、このマクロは使用しないでください。

このマクロは、vt が VT_DISPATCH または VT_UNKNOWN の場合にのみ有効です。 vt の別の値をこのマクロに渡すと、コンパイルエラーが発生します。 vt のそれ以外の値では、PROP_ENTRY_TYPE_EX を使用します。

BEGIN_PROP_MAP マクロと END_PROP_MAP マクロは、プロパティマップの開始位置と終了位置をそれぞれ示します。

初期化する必要がある Web コントロールを作成する場合は、IPersistStreamInitImpl の代わりに IPersistPropertyBagImpl クラスを使用してプロパティを初期化します。 IPersistStreamInitImpl は、バイナリ形式の場合、IPersistPropertyBagImpl に比べて大きなリスクを伴います。