Marshal.AddRef(IntPtr) Метод

Определение

Пространство имен:

System.Runtime.InteropServices

Сборка:

System.Runtime.InteropServices.dll

Исходный код:

Marshal.cs

Увеличивает счетчик ссылок для указанного интерфейса.

public:
 static int AddRef(IntPtr pUnk);

public static int AddRef (IntPtr pUnk);

static member AddRef : nativeint -> int

Public Shared Function AddRef (pUnk As IntPtr) As Integer

Параметры

pUnk

IntPtr

nativeint

Увеличиваемый счетчик ссылок интерфейса.

Возвращаемое значение

Int32

Новое значение счетчика ссылок для параметра pUnk.

Комментарии

Среда CLR управляет числом ссылок com-объекта, поэтому использовать этот метод напрямую не требуется. В редких случаях, например при тестировании пользовательского маршалера, может потребоваться управлять временем существования объекта вручную. После вызова AddRefнеобходимо уменьшать количество ссылок с помощью метода, Marshal.Releaseнапример . Не полагайтесь на возвращаемое значение AddRef, так как оно иногда может быть нестабильным.

Можно вызвать Marshal.GetComInterfaceForObject, Marshal.GetIUnknownForObjectили Marshal.GetIDispatchForObject , чтобы получить IntPtr значение, представляющее указатель интерфейса IUnknown . Вы также можете использовать эти методы и AddRef метод для управляемых объектов, чтобы получить ИНТЕРФЕЙСы COM, представленные вызываемой оболочкой COM управляемого объекта. Если вы не знакомы со сведениями об этом типе оболочки, см. статью Вызываемая оболочка COM.

См. также раздел

• Release(IntPtr)
• QueryInterface(IntPtr, Guid, IntPtr)
• GetComInterfaceForObject(Object, Type)
• GetIUnknownForObject(Object)
• GetIDispatchForObject(Object)
• IUnknown::AddRef