Marshal.GetIUnknownForObject(Object) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает интерфейс IUnknown из управляемого объекта.
public:
static IntPtr GetIUnknownForObject(System::Object ^ o);
[System.Security.SecurityCritical]
public static IntPtr GetIUnknownForObject (object o);
[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static IntPtr GetIUnknownForObject (object o);
public static IntPtr GetIUnknownForObject (object o);
[<System.Security.SecurityCritical>]
static member GetIUnknownForObject : obj -> nativeint
[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member GetIUnknownForObject : obj -> nativeint
static member GetIUnknownForObject : obj -> nativeint
Public Shared Function GetIUnknownForObject (o As Object) As IntPtr
Параметры
- o
- Object
Объект, для которого запрашивается интерфейс IUnknown
.
Возвращаемое значение
-
IntPtr
nativeint
Указатель IUnknown
для параметра o
.
- Атрибуты
Примеры
В следующем примере показано, как получить интерфейс IUnknown для управляемого GetIUnknownForObject объекта с помощью метода.
using System;
using System.Runtime.InteropServices;
class Program
{
static void Run()
{
// Create an int object
int obj = 1;
Console.WriteLine("Calling Marshal.GetIUnknownForObject...");
// Get the IUnKnown pointer for the Integer object
IntPtr pointer = Marshal.GetIUnknownForObject(obj);
Console.WriteLine("Calling Marshal.Release...");
// Always call Marshal.Release to decrement the reference count.
Marshal.Release(pointer);
}
static void Main(string[] args)
{
Run();
}
}
Imports System.Runtime.InteropServices
Module Program
Sub Run()
' Dim an Integer object
Dim IntegerObject As Integer = 1
' Dim a pointer
Dim pointer As IntPtr
Console.WriteLine("Calling Marshal.GetIUnknownForObject...")
' Get the IUnKnown pointer for the Integer object
pointer = Marshal.GetIUnknownForObject(IntegerObject)
Console.WriteLine("Calling Marshal.Release...")
' Always call Marshal.Release to decrement the reference count.
Marshal.Release(pointer)
End Sub
Sub Main(ByVal args() As String)
Run()
End Sub
End Module
Комментарии
В управляемом коде редко работает непосредственно с интерфейсом IUnknown
. GetIUnknownForObject Однако это полезно при вызове метода, предоставляющего параметр COM-объекта в качестве IntPtr типа или с пользовательским маршалингом. Вызов объекта с этим методом приводит к добавочному количеству ссылок на указатель интерфейса перед возвратом указателя. Всегда используется для Marshal.Release уменьшения количества ссылок после завершения работы с указателем. Этот метод предоставляет противоположные функциональные возможности Marshal.GetObjectForIUnknown метода.
Этот метод также можно использовать в управляемом объекте для получения указателя интерфейса на вызываемую оболочку COM для объекта.