次の方法で共有

ITDispatchMapper::QueryDispatchInterface メソッド (tapi3if.h)

  • [アーティクル]

QueryDispatchInterface メソッドは、GUID とオブジェクト上の別のインターフェイスのディスパッチ ポインターを指定して、オブジェクト上の別のインターフェイスへのディスパッチ ポインターを返します。

構文

HRESULT QueryDispatchInterface(
  [in]  BSTR      pIID,
  [in]  IDispatch *pInterfaceToMap,
  [out] IDispatch **ppReturnedInterface
);

パラメーター

[in] pIID

必要なインターフェイスの GUID の BSTR 表現へのポインター。

[in] pInterfaceToMap

開始インターフェイスの IDispatch ポインター。

[out] ppReturnedInterface

pIID に含まれる GUID に対応するインターフェイスの IDispatch ポインター。

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

リターン コード 説明
S_OK
 メソッドが成功しました。
E_OUTOFMEMORY
 操作を実行するためのメモリが不足しています。
E_INVALIDARG
 pIID パラメーターが有効な BSTR ではないか、有効な GUID に変換されません。
E_NOINTERFACE
 要求されたインターフェイスが公開されていないか、オブジェクトが IObjectSafety インターフェイスを実装していません。

注釈

アプリケーションでは 、SysAllocString を使用して pIID パラメーターのメモリを割り当て、変数が不要になったときに SysFreeString を使用してメモリを解放する必要があります。

Dispatch Mapper は、オブジェクトの IObjectSafety インターフェイスを使用して、オブジェクトが要求されたインターフェイスでのスクリプト作成に安全であることを確認します。 オブジェクトが IObjectSafety を実装していない場合、またはオブジェクトがこの特定のインターフェイスで安全でない場合、呼び出しは失敗します。

要件

要件 値
対象プラットフォーム Windows
ヘッダー tapi3if.h (Tapi3.h を含む)
Library Uuid.lib
[DLL] Tapi3.dll

こちらもご覧ください

ITDispatchMapper