Marshal.AddRef(IntPtr) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee wordt het aantal verwijzingen op de opgegeven interface verhoogd.
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 -> intstatic member AddRef : nativeint -> int[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member AddRef : nativeint -> intPublic Shared Function AddRef (pUnk As IntPtr) As IntegerParameters
- pUnk
-
IntPtr
nativeint
Het aantal interfacereferenties dat moet worden verhoogd.
Retouren
De nieuwe waarde van het verwijzingsaantal op de pUnk parameter.
- Kenmerken
Opmerkingen
De algemene taalruntime beheert het referentieaantal van een COM-object voor u, waardoor het niet nodig is om deze methode rechtstreeks te gebruiken. In zeldzame gevallen, zoals het testen van een aangepaste marshaler, kan het nodig zijn om de levensduur van een object handmatig te bewerken. Na het aanroepen AddRefmoet u het aantal verwijzingen verlagen met behulp van een methode zoals Marshal.Release. Vertrouw niet op de retourwaarde van AddRef, omdat deze soms instabiel kan zijn.
U kunt een aanroep Marshal.GetComInterfaceForObject, Marshal.GetIUnknownForObjectof Marshal.GetIDispatchForObject een waarde verkrijgen IntPtr die een IUnknown-interfaceaanwijzer vertegenwoordigt. U kunt deze methoden en de AddRef methode op beheerde objecten ook gebruiken om de COM-interfaces te verkrijgen die worden vertegenwoordigd door de COM-aanroepbare wrapper van het beheerde object. Als u niet bekend bent met de details van dit wrapper-type, raadpleegt u COM Callable Wrapper.
