Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Metodo Marshal.AddRef (IntPtr)

 

Data di pubblicazione: ottobre 2016

Incrementa il numero di riferimenti nell'interfaccia specificata.

Spazio dei nomi:   System.Runtime.InteropServices
Assembly:  mscorlib (in mscorlib.dll)

[SecurityCriticalAttribute]
public static int AddRef(
	IntPtr pUnk
)

Parametri

pUnk
Type: System.IntPtr

Numero di riferimenti nell'interfaccia da incrementare.

Valore restituito

Type: System.Int32

Nuovo valore del conteggio dei riferimenti sul parametro pUnk.

Common language runtime gestisce il conteggio dei riferimenti di un oggetto COM per l'utente, rendendo inutile utilizzare direttamente questo metodo. In rari casi, ad esempio test di un gestore di marshalling personalizzato, può risultare necessario modificare manualmente la durata dell'oggetto. Dopo la chiamata AddRef, è necessario diminuire il conteggio dei riferimenti utilizzando un metodo, ad esempio Marshal.Release. Non fare affidamento sul valore restituito di AddRef, come può talvolta essere instabile.

È possibile chiamare Marshal.GetComInterfaceForObject, Marshal.GetIUnknownForObject, o Marshal.GetIDispatchForObject per ottenere un IntPtr che rappresenta un IUnknown puntatore a interfaccia. È inoltre possibile utilizzare questi metodi e AddRef metodo su oggetti gestiti per ottenere le interfacce COM rappresentate da wrapper chiamabile COM dell'oggetto gestito. Se non ha familiarità con i dettagli di questo tipo di wrapper, vedere COM Callable Wrapper.

SecurityCriticalAttribute

requires full trust for the immediate caller. This member cannot be used by partially trusted or transparent code.

Universal Windows Platform
Disponibile da 8
.NET Framework
Disponibile da 1.1
Libreria di classi portabile
Supportato in: piattaforme .NET portabili
Windows Phone Silverlight
Disponibile da 8.0
Windows Phone
Disponibile da 8.1
Torna all'inizio
Mostra: