Marshal.GetComInterfaceForObject メソッド

リファレンス

定義

名前空間:: System.Runtime.InteropServices

アセンブリ:: System.Runtime.InteropServices.dll

アセンブリ:: mscorlib.dll

アセンブリ:: netstandard.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

オブジェクトのインターフェイスを表すインターフェイスポインターを返します。

オーバーロード

GetComInterfaceForObject(Object, Type)	古い. 指定したオブジェクトの指定したインターフェイスを表す IUnknown インターフェイスへのポインターを返します。カスタムクエリインターフェイスアクセスは既定で有効になっています。
GetComInterfaceForObject(Object, Type, CustomQueryInterfaceMode)	古い. 指定したオブジェクトの指定したインターフェイスを表す IUnknown インターフェイスへのポインターを返します。カスタムクエリインターフェイスアクセスは、指定したカスタマイズモードで制御されます。
GetComInterfaceForObject<T,TInterface>(T)	指定した型のオブジェクトの指定したインターフェイスを表す IUnknown インターフェイスへのポインターを返します。カスタムクエリインターフェイスアクセスは既定で有効になっています。

GetComInterfaceForObject(Object, Type)

ソース:: Marshal.NoCom.cs

ソース:: Marshal.NoCom.cs

ソース:: Marshal.NoCom.cs

注意事項

GetComInterfaceForObject(Object, Type) may be unavailable in future releases. Instead, use GetComInterfaceForObject<T,T2>(T). For more info, go to http://go.microsoft.com/fwlink/?LinkID=296509

指定したオブジェクトの指定したインターフェイスを表す IUnknown インターフェイスへのポインターを返します。カスタムクエリインターフェイスアクセスは既定で有効になっています。

public:
 static IntPtr GetComInterfaceForObject(System::Object ^ o, Type ^ T);

[System.Obsolete("GetComInterfaceForObject(Object, Type) may be unavailable in future releases. Instead, use GetComInterfaceForObject<T,T2>(T). For more info, go to http://go.microsoft.com/fwlink/?LinkID=296509")]
[System.Security.SecurityCritical]
public static IntPtr GetComInterfaceForObject (object o, Type T);

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static IntPtr GetComInterfaceForObject (object o, Type T);

[System.Security.SecurityCritical]
public static IntPtr GetComInterfaceForObject (object o, Type T);

public static IntPtr GetComInterfaceForObject (object o, Type T);

[<System.Obsolete("GetComInterfaceForObject(Object, Type) may be unavailable in future releases. Instead, use GetComInterfaceForObject<T,T2>(T). For more info, go to http://go.microsoft.com/fwlink/?LinkID=296509")>]
[<System.Security.SecurityCritical>]
static member GetComInterfaceForObject : obj * Type -> nativeint

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member GetComInterfaceForObject : obj * Type -> nativeint

[<System.Security.SecurityCritical>]
static member GetComInterfaceForObject : obj * Type -> nativeint

static member GetComInterfaceForObject : obj * Type -> nativeint

Public Shared Function GetComInterfaceForObject (o As Object, T As Type) As IntPtr

パラメーター

o: Object

インターフェイスを提供するオブジェクト。

T: Type

要求されるインターフェイスの型。

戻り値

IntPtr

オブジェクトの指定したインターフェイスを表すインターフェイスポインター。

属性: ObsoleteAttribute SecurityCriticalAttribute SupportedOSPlatformAttribute

例外

ArgumentException

T パラメーターがインターフェイスではありません。

または

型が COM から参照できません。

または

T パラメーターがジェネリック型定義です。

InvalidCastException

o パラメーターが要求されたインターフェイスをサポートしていません。

ArgumentNullException

o パラメーターが null です。

または

T パラメーターが null です。

注釈

このメソッドは、指定したオブジェクトで要求されたインターフェイスを表すインターフェイスポインターを返します。インターフェイスポインターが渡されることを期待するアンマネージメソッドがある場合は、特に便利です。このメソッドを使用してオブジェクトを呼び出すと、ポインターが返される前に、インターフェイスポインターで参照カウントがインクリメントされます。ポインターが終了したら、常にを使用 Marshal.Release して参照カウントをデクリメントします。生の COM インターフェイスポインターを使用する場合は、COM によって定義された規則に従う必要があります。

GetComInterfaceForObject(Object, Type) は、COM オブジェクトパラメーターを型として IntPtr 公開するメソッドを呼び出す場合や、カスタムマーシャリングを使用する場合に便利です。あまり一般的ではありませんが、マネージドオブジェクトでこのメソッドを使用して、オブジェクトの COM 呼び出し可能ラッパーへのポインターを取得できます。たとえば、COM にエクスポートされるマネージドオブジェクトでを使用 GetComInterfaceForObject(Object, Type) して、の System.Runtime.InteropServices.UCOMIConnectionPointContainerインターフェイスポインターを取得できます。クラスインターフェイスには、2 番目のパラメーター (t) に渡す対応する型がないため、クラスインターフェイスへのポインターを取得できません。代わりに、を使用 Marshal.GetIDispatchForObject して、COM 呼び出し可能ラッパーの既定のインターフェイス (通常は自動ディスパッチクラスインターフェイス) でメンバーを呼び出します。

メソッドオーバーロードを GetComInterfaceForObject(Object, Type) 使用すると、既定でクエリインターフェイスをカスタマイズできます。クエリインターフェイスのカスタマイズを適用するかどうかを指定するには、メソッドのオーバーロードを GetComInterfaceForObject(Object, Type, CustomQueryInterfaceMode) 使用します。

詳細については、 COM 呼び出し可能ラッパーとランタイム呼び出し可能ラッパーに関する記事を参照してください。

こちらもご覧ください

適用対象

.NET 9 およびその他のバージョン

製品	バージョン (廃止)
.NET	Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 (Core 1.0)
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.1, 2.0, 2.1 (1.2, 1.3, 1.4, 1.5, 1.6)
UWP	(10.0)

GetComInterfaceForObject(Object, Type, CustomQueryInterfaceMode)

ソース:: Marshal.NoCom.cs

ソース:: Marshal.NoCom.cs

ソース:: Marshal.NoCom.cs

注意事項

GetComInterfaceForObject(Object, Type, CustomQueryInterfaceMode) and support for ICustomQueryInterface may be unavailable in future releases.

指定したオブジェクトの指定したインターフェイスを表す IUnknown インターフェイスへのポインターを返します。カスタムクエリインターフェイスアクセスは、指定したカスタマイズモードで制御されます。

public:
 static IntPtr GetComInterfaceForObject(System::Object ^ o, Type ^ T, System::Runtime::InteropServices::CustomQueryInterfaceMode mode);

[System.Obsolete("GetComInterfaceForObject(Object, Type, CustomQueryInterfaceMode) and support for ICustomQueryInterface may be unavailable in future releases.")]
[System.Security.SecurityCritical]
public static IntPtr GetComInterfaceForObject (object o, Type T, System.Runtime.InteropServices.CustomQueryInterfaceMode mode);

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static IntPtr GetComInterfaceForObject (object o, Type T, System.Runtime.InteropServices.CustomQueryInterfaceMode mode);

[System.Security.SecurityCritical]
public static IntPtr GetComInterfaceForObject (object o, Type T, System.Runtime.InteropServices.CustomQueryInterfaceMode mode);

public static IntPtr GetComInterfaceForObject (object o, Type T, System.Runtime.InteropServices.CustomQueryInterfaceMode mode);

[<System.Obsolete("GetComInterfaceForObject(Object, Type, CustomQueryInterfaceMode) and support for ICustomQueryInterface may be unavailable in future releases.")>]
[<System.Security.SecurityCritical>]
static member GetComInterfaceForObject : obj * Type * System.Runtime.InteropServices.CustomQueryInterfaceMode -> nativeint

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member GetComInterfaceForObject : obj * Type * System.Runtime.InteropServices.CustomQueryInterfaceMode -> nativeint

[<System.Security.SecurityCritical>]
static member GetComInterfaceForObject : obj * Type * System.Runtime.InteropServices.CustomQueryInterfaceMode -> nativeint

static member GetComInterfaceForObject : obj * Type * System.Runtime.InteropServices.CustomQueryInterfaceMode -> nativeint

Public Shared Function GetComInterfaceForObject (o As Object, T As Type, mode As CustomQueryInterfaceMode) As IntPtr

パラメーター

o: Object

インターフェイスを提供するオブジェクト。

T: Type

要求されるインターフェイスの型。

mode: CustomQueryInterfaceMode

ICustomQueryInterface によって提供される IUnknown::QueryInterface カスタマイズを適用するかどうかを示す列挙値のいずれか。

戻り値

IntPtr

オブジェクトのインターフェイスを表すインターフェイスポインター。

属性: ObsoleteAttribute SecurityCriticalAttribute SupportedOSPlatformAttribute

例外

ArgumentException

T パラメーターがインターフェイスではありません。

または

型が COM から参照できません。

または

T パラメーターがジェネリック型定義です。

InvalidCastException

オブジェクト o が要求されたインターフェイスをサポートしていません。

ArgumentNullException

o パラメーターが null です。

または

T パラメーターが null です。

注釈

GetComInterfaceForObject(Object, Type, CustomQueryInterfaceMode) では、クエリインターフェイスのカスタマイズを適用するかどうかを指定できます。既定では、オーバーロードを GetComInterfaceForObject(Object, Type) 使用してクエリインターフェイスのカスタマイズを適用します。

適用対象

.NET 9 およびその他のバージョン

製品	バージョン (廃止)
.NET	Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 (Core 1.0)
.NET Framework	4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.1, 2.0, 2.1 (1.2, 1.3, 1.4, 1.5, 1.6)
UWP	(10.0)

GetComInterfaceForObject<T,TInterface>(T)

ソース:: Marshal.NoCom.cs

ソース:: Marshal.NoCom.cs

ソース:: Marshal.NoCom.cs

指定した型のオブジェクトの指定したインターフェイスを表す IUnknown インターフェイスへのポインターを返します。カスタムクエリインターフェイスアクセスは既定で有効になっています。

public:
generic <typename T, typename TInterface>
 static IntPtr GetComInterfaceForObject(T o);

[System.Security.SecurityCritical]
public static IntPtr GetComInterfaceForObject<T,TInterface> (T o);

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static IntPtr GetComInterfaceForObject<T,TInterface> (T o);

public static IntPtr GetComInterfaceForObject<T,TInterface> (T o);

[<System.Security.SecurityCritical>]
static member GetComInterfaceForObject : 'T -> nativeint

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member GetComInterfaceForObject : 'T -> nativeint

static member GetComInterfaceForObject : 'T -> nativeint

Public Shared Function GetComInterfaceForObject(Of T, TInterface) (o As T) As IntPtr

型パラメーター

T

o の型。

TInterface

返すインターフェイスの型。

パラメーター

o: T

インターフェイスを提供するオブジェクト。

戻り値

IntPtr

TInterface インターフェイスを表すインターフェイスポインター。

属性: SecurityCriticalAttribute SupportedOSPlatformAttribute

例外

ArgumentException

TInterface パラメーターがインターフェイスではありません。

または

型が COM から参照できません。

または

T パラメーターがオープンジェネリック型です。

InvalidCastException

o パラメーターが TInterface インターフェイスをサポートしていません。

ArgumentNullException

o パラメーターが null です。

注釈

このメソッドは、指定したオブジェクトのインターフェイスを TInterface 表すインターフェイスポインターを返します。インターフェイスポインターが渡されることを期待するアンマネージメソッドがある場合は、特に便利です。このメソッドを使用してオブジェクトを呼び出すと、ポインターが返される前に、インターフェイスポインターで参照カウントがインクリメントされます。ポインターが Marshal.Release 終了したら、常にメソッドを使用して参照カウントをデクリメントします。生の COM インターフェイスポインターを使用する場合は、COM によって定義された規則に従う必要があります。

GetComInterfaceForObject<T,TInterface>(T) は、COM オブジェクトパラメーターを型として IntPtr 公開するメソッドを呼び出す場合や、カスタムマーシャリングを使用する場合に便利です。マネージドオブジェクトでこのメソッドを使用して、オブジェクトの COM 呼び出し可能ラッパーへのポインターを取得することもできますが、これはあまり一般的ではありません。たとえば、COM にエクスポートされるマネージドオブジェクトでを使用 GetComInterfaceForObject<T,TInterface>(T) して、の System.Runtime.InteropServices.UCOMIConnectionPointContainerインターフェイスポインターを取得できます。

メソッドオーバーロードを GetComInterfaceForObject<T,TInterface>(T) 使用すると、既定でクエリインターフェイスをカスタマイズできます。クエリインターフェイスのカスタマイズを適用するかどうかを指定するには、メソッドのオーバーロードを GetComInterfaceForObject(Object, Type, CustomQueryInterfaceMode) 使用します。

詳細については、 COM 呼び出し可能ラッパーとランタイム呼び出し可能ラッパーに関する記事を参照してください。

適用対象

.NET 9 およびその他のバージョン

製品	バージョン
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

次の方法で共有

Marshal.GetComInterfaceForObject メソッド

定義

オーバーロード

GetComInterfaceForObject(Object, Type)

パラメーター

戻り値

例外

注釈

こちらもご覧ください

適用対象

GetComInterfaceForObject(Object, Type, CustomQueryInterfaceMode)

パラメーター

戻り値

例外

注釈

適用対象

GetComInterfaceForObject<T,TInterface>(T)

型パラメーター

パラメーター

戻り値

例外

注釈

適用対象

その他のリソース