次の方法で共有

Marshal.QueryInterface メソッド

  • [アーティクル]

COM オブジェクトから指定したインターフェイスへのポインタを要求します。

Public Shared Function QueryInterface( _
   ByVal pUnk As IntPtr, _   ByRef iid As Guid, _   <Out()> ByRef ppv As IntPtr _) As Integer
[C#]
public static int QueryInterface(IntPtrpUnk,   ref Guidiid,   out IntPtrppv);
[C++]
public: static int QueryInterface(IntPtrpUnk,Guid* iid,   [   Out] IntPtr* ppv);
[JScript]
public static function QueryInterface(
   pUnk : IntPtr,iid : Guid,ppv : IntPtr) : int;

パラメータ

  • pUnk
    照会するインターフェイス。
  • iid
    要求したインターフェイスのインターフェイス ID (IID) である Guid (参照渡し)。
  • ppv
    このメソッドが返されるときに、返されたインターフェイスへの参照を格納します。

戻り値

返されたインターフェイス。

解説

QueryInterface メソッドは COM オブジェクトの IUnknown::QueryInterface を公開します。これは、指定されたインターフェイス ポインタを取得しようとします。COM オブジェクトで QueryInterface を使用することは、マネージ コードでキャストを実行することと同じです。このメソッドでオブジェクトを呼び出すと、ポインタが返される前に、インターフェイス ポインタで参照カウントがインクリメントされます。ポインタの使用が終わったときは、必ず Marshal.Release を使用して参照カウントをデクリメントしてください。 IUnknown インターフェイス ポインタを表す IntPtr の値を取得するには、 Marshal.GetComInterfaceForObject 、 Marshal.GetIUnknownForObject 、または Marshal.GetIDispatchForObject を使用できます。

メモ   このメソッドは SecurityAction.LinkDemand を使用して、信頼関係のないコードからの呼び出しを防ぎます。 SecurityPermissionAttribute.UnmanagedCode アクセス許可は、直前の呼び出し元にのみ要求されます。信頼性が一部しか確認されていないコードから呼び出すことができるコードの場合、ユーザー入力を検証せずに Marshal クラスに渡すことは避けてください。 LinkDemand メンバの使用に関する重要な制約事項については、「 Demand と LinkDemand 」を参照してください。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

.NET Framework セキュリティ:

参照

Marshal クラス | Marshal メンバ | System.Runtime.InteropServices 名前空間 | AddRef | Release | GetComInterfaceForObject | GetIUnknownForObject | GetIDispatchForObject | GetObjectForIUnknown