Marshal.QueryInterface メソッドとは? わかりやすく解説

Weblio 辞書 > コンピュータ > .NET Framework クラス ライブラリ リファレンス > Marshal.QueryInterface メソッドの意味・解説 

Marshal.QueryInterface メソッド

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

名前空間: System.Runtime.InteropServices
アセンブリ: mscorlib (mscorlib.dll 内)
構文構文

Public Shared Function QueryInterface
 ( _
    pUnk As IntPtr, _
    ByRef iid As Guid, _
    <OutAttribute> ByRef ppv As IntPtr
 _
) As Integer
Dim pUnk As IntPtr
Dim iid As Guid
Dim ppv As IntPtr
Dim returnValue As Integer

returnValue = Marshal.QueryInterface(pUnk, iid, ppv)
public static int QueryInterface
 (
    IntPtr pUnk,
    ref Guid iid,
    out IntPtr ppv
)
public:
static int QueryInterface (
    IntPtr pUnk, 
    Guid% iid, 
    [OutAttribute] IntPtr% ppv
)
public static int QueryInterface
 (
    IntPtr pUnk, 
    /** @ref */ Guid iid, 
    /** @attribute OutAttribute() */ /** @ref */ IntPtr ppv
)
JScript では、値型の引数は参照渡しされません。

パラメータ

pUnk

照会するインターフェイス。

iid

要求したインターフェイスのインターフェイス ID (IID) である Guid (参照渡し)。

ppv

このメソッドが返されるときに、返されたインターフェイスへの参照を格納します。

戻り値
呼び出しの成功または失敗を示す HRESULT。

解説解説

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

メモメモ

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

.NET Framework のセキュリティ.NET Framework のセキュリティ
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
Marshal クラス
Marshal メンバ
System.Runtime.InteropServices 名前空間
AddRef
Release
GetComInterfaceForObject
GetIUnknownForObject
GetIDispatchForObject
GetObjectForIUnknown



英和和英テキスト翻訳

英語⇒日本語日本語⇒英語

辞書ショートカット

すべての辞書の索引

「Marshal.QueryInterface メソッド」の関連用語

1
14% |||||

Marshal.QueryInterface メソッドのお隣キーワード
検索ランキング

   

英語⇒日本語
日本語⇒英語
   



Marshal.QueryInterface メソッドのページの著作権

   
日本マイクロソフト株式会社日本マイクロソフト株式会社
© 2026 Microsoft.All rights reserved.

©2026 GRAS Group, Inc.RSS