Marshal.AddRef(IntPtr) Metódus

Definíció

Névtér:

System.Runtime.InteropServices

Szerelvények:

netstandard.dll, System.Runtime.InteropServices.dll

Forrás:

Marshal.cs

Növeli a hivatkozás számát a megadott felületen.

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

Paraméterek

pUnk

IntPtr

nativeint

Az illesztőhivatkozások száma a növekményre.

Válaszok

Int32

A hivatkozás új értéke a paraméterre számít pUnk .

Megjegyzések

A közös nyelvi futtatókörnyezet kezeli a COM-objektumok referenciaszámát, így szükségtelen a módszer közvetlen használata. Ritka esetekben, például egy egyéni marsall tesztelése esetén szükség lehet egy objektum élettartamának manuális módosítására. A hívás AddRefután a hivatkozási számot egy olyan módszerrel kell lecsökkenteni, mint a Marshal.Release. Ne függenek a visszatérési értékétől AddRef, mert az néha instabil lehet.

Meghívhat Marshal.GetComInterfaceForObject, Marshal.GetIUnknownForObjectvagy Marshal.GetIDispatchForObject beolvashat egy IntPtrIUnknown felületmutatót jelképező értéket. Ezeket a metódusokat és a AddRef felügyelt objektumokon lévő metódust is használhatja a felügyelt objektum COM-hívó burkolója által képviselt COM-felületek beszerzéséhez. Ha nem ismeri ennek a burkolótípusnak a részleteit, tekintse meg a COM hívható burkolóját.

Lásd még

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