Marshal.AddRef(IntPtr) Metodo

Riferimento

Definizione

Spazio dei nomi:: System.Runtime.InteropServices

Assembly:: System.Runtime.InteropServices.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Incrementa il numero di riferimenti nell'interfaccia specificata.

public:
 static int AddRef(IntPtr pUnk);

[System.Security.SecurityCritical]
public static int AddRef (IntPtr pUnk);

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static int AddRef (IntPtr pUnk);

public static int AddRef (IntPtr pUnk);

[<System.Security.SecurityCritical>]
static member AddRef : nativeint -> int

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member AddRef : nativeint -> int

static member AddRef : nativeint -> int

Public Shared Function AddRef (pUnk As IntPtr) As Integer

Parametri

pUnk: IntPtr
nativeint

Numero di riferimenti nell'interfaccia da incrementare.

Restituisce

Int32

Nuovo valore del conteggio dei riferimenti sul parametro pUnk.

Attributi: SecurityCriticalAttribute SupportedOSPlatformAttribute

Commenti

Common Language Runtime gestisce il conteggio dei riferimenti di un oggetto COM da usare direttamente. In rari casi, ad esempio il test di un marshalling personalizzato, potrebbe essere necessario modificare manualmente la durata di un oggetto. Dopo aver chiamato AddRef, è necessario decrerere il conteggio dei riferimenti usando un metodo come Marshal.Release. Non basarsi sul valore restituito di AddRef, perché a volte può essere instabile.

È possibile chiamare Marshal.GetComInterfaceForObject, Marshal.GetIUnknownForObjecto Marshal.GetIDispatchForObject per ottenere un valore che rappresenta un IntPtr puntatore dell'interfaccia IUnknown . È anche possibile usare questi metodi e il AddRef metodo sugli oggetti gestiti per ottenere le interfacce COM rappresentate dal wrapper chiamabile COM dell'oggetto gestito. Se non si ha familiarità con i dettagli di questo tipo wrapper, vedere COM Callable Wrapper.

Si applica a