Marshal.AddRef(IntPtr) Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Ö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.