Marshal.GetComInterfaceForObject Yöntem

  • Başvuru

Tanım

Ad Alanı:
System.Runtime.InteropServices
Bütünleştirilmiş Kod:
System.Runtime.InteropServices.dll
Bütünleştirilmiş Kod:
mscorlib.dll
Bütünleştirilmiş Kod:
netstandard.dll

Bir nesnenin arabirimini temsil eden bir arabirim işaretçisi döndürür.

Aşırı Yüklemeler

GetComInterfaceForObject(Object, Type)
Geçersiz.

Belirtilen nesnede belirtilen arabirimi temsil eden IUnknown arabirimine bir işaretçi döndürür. Özel sorgu arabirimi erişimi varsayılan olarak etkindir.
GetComInterfaceForObject(Object, Type, CustomQueryInterfaceMode)
Geçersiz.

Belirtilen nesnede belirtilen arabirimi temsil eden IUnknown arabirimine bir işaretçi döndürür. Özel sorgu arabirimi erişimi belirtilen özelleştirme modu tarafından denetlendi.
GetComInterfaceForObject<T,TInterface>(T)

Belirtilen türdeki bir nesnede belirtilen arabirimi temsil eden IUnknown arabirimine bir işaretçi döndürür. Özel sorgu arabirimi erişimi varsayılan olarak etkindir.

GetComInterfaceForObject(Object, Type)

Kaynak:
Marshal.NoCom.cs
Kaynak:
Marshal.NoCom.cs
Kaynak:
Marshal.NoCom.cs

Dikkat

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

Belirtilen nesnede belirtilen arabirimi temsil eden IUnknown arabirimine bir işaretçi döndürür. Özel sorgu arabirimi erişimi varsayılan olarak etkindir.

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

Parametreler

o
Object

Arabirimi sağlayan nesne.

T
Type

İstenen arabirim türü.

Döndürülenler

IntPtr

nativeint

Nesne için belirtilen arabirimi temsil eden arabirim işaretçisi.

Öznitelikler
ObsoleteAttribute SecurityCriticalAttribute SupportedOSPlatformAttribute

Özel durumlar

ArgumentException

T parametresi bir arabirim değil.

-veya-

Tür COM'a görünür değil.

-veya-

T parametresi genel bir tür tanımıdır.

InvalidCastException

o parametresi istenen arabirimi desteklemiyor.

ArgumentNullException

o parametresidirnull.

-veya-

T parametresidirnull.

Açıklamalar

Bu yöntem, belirtilen nesnede istenen arabirimi temsil eden bir arabirim işaretçisi döndürür. Bir arabirim işaretçisi geçirilmesini bekleyen yönetilmeyen bir yönteminiz varsa, özellikle yararlıdır. Bir nesneyi bu yöntemle çağırmak, işaretçi döndürülmeden önce arabirim işaretçisinde başvuru sayısının artmalarına neden olur. İşaretçiyi tamamladıktan sonra başvuru sayısını geri almak için her zaman kullanın Marshal.Release . Ham COM arabirim işaretçilerini kullanırken COM tarafından tanımlanan kurallara uymanız gerekir.

GetComInterfaceForObject(Object, Type) bir COM nesne parametresini tür olarak veya özel hazırlama ile kullanıma sunan bir IntPtr yöntemi çağırırken yararlıdır. Daha az yaygın olsa da, yönetilen bir nesnede bu yöntemi kullanarak nesnenin COM çağrılabilen sarmalayıcısına yönelik bir işaretçi elde edebilirsiniz. Örneğin, için System.Runtime.InteropServices.UCOMIConnectionPointContainerbir arabirim işaretçisi almak üzere COM'a aktarılan yönetilen bir nesnede kullanabilirsinizGetComInterfaceForObject(Object, Type). Sınıf arabirimi ikinci parametreye (t ) geçirmek için karşılık gelen türde olmadığından, sınıf arabirimine yönelik bir işaretçi alamazsınız. Bunun yerine, genellikle otomatik dağıtım sınıfı arabirimi olan COM çağrılabilir sarmalayıcının varsayılan arabiriminde üyeleri çağırmak için kullanın Marshal.GetIDispatchForObject .

Yöntem GetComInterfaceForObject(Object, Type) aşırı yüklemesi, varsayılan olarak sorgu arabirimi özelleştirmesine olanak tanır. Sorgu arabirimi özelleştirmesinin uygulanıp uygulanmayacağını belirtmek için yöntem aşırı yüklemesini GetComInterfaceForObject(Object, Type, CustomQueryInterfaceMode) kullanın.

Ek bilgi için COM Çağrılabilen Sarmalayıcı ve Çalışma Zamanı Çağrılabilen Sarmalayıcı makalelerine bakın.

Ayrıca bkz.

Şunlara uygulanır

GetComInterfaceForObject(Object, Type, CustomQueryInterfaceMode)

Kaynak:
Marshal.NoCom.cs
Kaynak:
Marshal.NoCom.cs
Kaynak:
Marshal.NoCom.cs

Dikkat

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

Belirtilen nesnede belirtilen arabirimi temsil eden IUnknown arabirimine bir işaretçi döndürür. Özel sorgu arabirimi erişimi belirtilen özelleştirme modu tarafından denetlendi.

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

Parametreler

o
Object

Arabirimi sağlayan nesne.

T
Type

İstenen arabirim türü.

mode
CustomQueryInterfaceMode

tarafından ICustomQueryInterfacesağlanan bir IUnknown::QueryInterface özelleştirmenin uygulanıp uygulanmayacağını gösteren numaralandırma değerlerinden biri.

Döndürülenler

IntPtr

nativeint

Nesnenin arabirimini temsil eden arabirim işaretçisi.

Öznitelikler
ObsoleteAttribute SecurityCriticalAttribute SupportedOSPlatformAttribute

Özel durumlar

ArgumentException

T parametresi bir arabirim değil.

-veya-

Tür COM'a görünür değil.

-veya-

T parametresi genel bir tür tanımıdır.

InvalidCastException

nesnesi o istenen arabirimi desteklemiyor.

ArgumentNullException

o parametresidirnull.

-veya-

T parametresidirnull.

Açıklamalar

GetComInterfaceForObject(Object, Type, CustomQueryInterfaceMode) sorgu arabirimi özelleştirmesi uygulanıp uygulanmayacağını belirtmenize olanak tanır. Sorgu arabirimi özelleştirmesini GetComInterfaceForObject(Object, Type) varsayılan olarak uygulamak için aşırı yüklemeyi kullanın.

Şunlara uygulanır

GetComInterfaceForObject<T,TInterface>(T)

Kaynak:
Marshal.NoCom.cs
Kaynak:
Marshal.NoCom.cs
Kaynak:
Marshal.NoCom.cs

Belirtilen türdeki bir nesnede belirtilen arabirimi temsil eden IUnknown arabirimine bir işaretçi döndürür. Özel sorgu arabirimi erişimi varsayılan olarak etkindir.

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ür Parametreleri

T

türü o.

TInterface

Döndürülecek arabirimin türü.

Parametreler

o
T

Arabirimi sağlayan nesne.

Döndürülenler

IntPtr

nativeint

Arabirimi temsil eden arabirim işaretçisi TInterface .

Öznitelikler
SecurityCriticalAttribute SupportedOSPlatformAttribute

Özel durumlar

ArgumentException

TInterface parametresi bir arabirim değil.

-veya-

Tür COM'a görünür değil.

-veya-

T parametresi açık bir genel türdür.

InvalidCastException

o parametresi arabirimini TInterface desteklemiyor.

ArgumentNullException

o parametresidirnull.

Açıklamalar

Bu yöntem, belirtilen nesnedeki TInterface arabirimi temsil eden bir arabirim işaretçisi döndürür. Bir arabirim işaretçisi geçirilmesini bekleyen yönetilmeyen bir yönteminiz varsa, özellikle yararlıdır. Bir nesneyi bu yöntemle çağırmak, işaretçi döndürülmeden önce arabirim işaretçisinde başvuru sayısının artmalarına neden olur. İşaretçiyle Marshal.Release işiniz bittiğinde başvuru sayısını geri almak için her zaman yöntemini kullanın. Ham COM arabirim işaretçilerini kullanırken COM tarafından tanımlanan kurallara uymanız gerekir.

GetComInterfaceForObject<T,TInterface>(T) bir COM nesne parametresini tür olarak veya özel hazırlama ile kullanıma sunan bir IntPtr yöntemi çağırırken yararlıdır. Bu yöntem, daha az yaygın olsa da, nesnenin COM çağrılabilen sarmalayıcısının işaretçisini almak için yönetilen bir nesnede de kullanabilirsiniz. Örneğin, için System.Runtime.InteropServices.UCOMIConnectionPointContainerbir arabirim işaretçisi almak üzere COM'a aktarılan yönetilen bir nesnede kullanabilirsinizGetComInterfaceForObject<T,TInterface>(T).

Yöntem GetComInterfaceForObject<T,TInterface>(T) aşırı yüklemesi, varsayılan olarak sorgu arabirimi özelleştirmesine olanak tanır. Sorgu arabirimi özelleştirmesinin uygulanıp uygulanmayacağını belirtmek için yöntem aşırı yüklemesini GetComInterfaceForObject(Object, Type, CustomQueryInterfaceMode) kullanın.

Ek bilgi için COM Çağrılabilen Sarmalayıcı ve Çalışma Zamanı Çağrılabilen Sarmalayıcı makalelerine bakın.

Şunlara uygulanır