Marshal.AddRef(IntPtr) Metod

Definition

Ökar referensantalet för det angivna gränssnittet.

public:
 static int AddRef(IntPtr pUnk);
[System.Security.SecurityCritical]
public static int AddRef(IntPtr pUnk);
public static int AddRef(IntPtr pUnk);
[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static int AddRef(IntPtr pUnk);
[<System.Security.SecurityCritical>]
static member AddRef : nativeint -> int
static member AddRef : nativeint -> int
[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member AddRef : nativeint -> int
Public Shared Function AddRef (pUnk As IntPtr) As Integer

Parametrar

pUnk
IntPtr

nativeint

Gränssnittsreferensantalet för att öka.

Returer

Det nya värdet för referensantalet för parametern pUnk .

Attribut

Kommentarer

Den vanliga språkkörningen hanterar referensantalet för ett COM-objekt åt dig, vilket gör det onödigt att använda den här metoden direkt. I sällsynta fall, till exempel genom att testa en anpassad marskalk, kan det vara nödvändigt att ändra ett objekts livslängd manuellt. När du har anropat AddRefmåste du minska referensantalet med hjälp av en metod som Marshal.Release. Förlita dig inte på returvärdet AddRefför , eftersom det ibland kan vara instabilt.

Du kan anropa Marshal.GetComInterfaceForObject, Marshal.GetIUnknownForObjecteller Marshal.GetIDispatchForObject hämta ett IntPtr värde som representerar en IUnknown-gränssnittspekare . Du kan också använda dessa metoder och AddRef metoden på hanterade objekt för att hämta COM-gränssnitten som representeras av det hanterade objektets COM-anropsbara omslutning. Om du inte känner till information om den här omslutningstypen kan du läsa MER i COM Callable Wrapper.

Gäller för

Se även