Marshal.GetComInterfaceForObject Yöntem
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Bir nesnenin arabirimini temsil eden bir arabirim işaretçisi döndürür.
| 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. |
- 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 -> nativeintstatic member GetComInterfaceForObject : obj * Type -> nativeintPublic Shared Function GetComInterfaceForObject (o As Object, T As Type) As IntPtrParametreler
- o
- Object
Arabirimi sağlayan nesne.
- T
- Type
İstenen arabirim türü.
Döndürülenler
nativeint
Nesne için belirtilen arabirimi temsil eden arabirim işaretçisi.
- Öznitelikler
Özel durumlar
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.
o parametresi istenen arabirimi desteklemiyor.
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.
- GetComInterfaceForObjectInContext(Object, Type)
- ComImportAttribute
- Release(IntPtr)
- UCOMIConnectionPointContainer
- GetIDispatchForObject(Object)
Şunlara uygulanır
.NET 9 ve diğer sürümler
| Ürün | Sürümler (Kullanım dışı) |
|---|---|
| .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) |
- 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 -> nativeintstatic member GetComInterfaceForObject : obj * Type * System.Runtime.InteropServices.CustomQueryInterfaceMode -> nativeintPublic Shared Function GetComInterfaceForObject (o As Object, T As Type, mode As CustomQueryInterfaceMode) As IntPtrParametreler
- o
- Object
Arabirimi sağlayan nesne.
- T
- Type
İstenen arabirim türü.
tarafından ICustomQueryInterfacesağlanan bir IUnknown::QueryInterface özelleştirmenin uygulanıp uygulanmayacağını gösteren numaralandırma değerlerinden biri.
Döndürülenler
nativeint
Nesnenin arabirimini temsil eden arabirim işaretçisi.
- Öznitelikler
Özel durumlar
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.
nesnesi o istenen arabirimi desteklemiyor.
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
.NET 9 ve diğer sürümler
| Ürün | Sürümler (Kullanım dışı) |
|---|---|
| .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) |
- 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 -> nativeintstatic member GetComInterfaceForObject : 'T -> nativeintPublic Shared Function GetComInterfaceForObject(Of T, TInterface) (o As T) As IntPtrTü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
nativeint
Arabirimi temsil eden arabirim işaretçisi TInterface .
- Öznitelikler
Özel durumlar
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.
o parametresi arabirimini TInterface desteklemiyor.
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
.NET 9 ve diğer sürümler
| Ürün | Sürümler |
|---|---|
| .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 |
.NET geri bildirimi
.NET, açık kaynak bir projedir. Geri bildirim sağlamak için bir bağlantı seçin: