Marshal.AddRef(IntPtr) Metodo
Definizione
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 conteggio dei riferimenti sull'interfaccia specificata.
public:
static int AddRef(IntPtr pUnk);[System.Security.SecurityCritical]
public static int AddRef(IntPtr pUnk);public static int AddRef(IntPtr pUnk);[<System.Security.SecurityCritical>]
static member AddRef : nativeint -> intstatic member AddRef : nativeint -> intPublic Shared Function AddRef (pUnk As IntPtr) As IntegerParametri
- pUnk
-
IntPtr
nativeint
Conteggio dei riferimenti dell'interfaccia da incrementare.
Valori restituiti
Nuovo valore del conteggio dei riferimenti nel pUnk parametro .
- Attributi
Commenti
Common Language Runtime gestisce automaticamente il conteggio dei riferimenti di un oggetto COM, rendendo superfluo l'uso diretto di questo metodo. In rari casi, ad esempio il test di un gestore di marshalling personalizzato, potrebbe essere necessario modificare manualmente la durata di un oggetto. Dopo aver chiamato AddRef, è necessario decrementare il conteggio dei riferimenti usando un metodo come Marshal.Release. Non fare affidamento sul valore restituito di AddRef, perché a volte può essere instabile.
È possibile chiamare Marshal.GetComInterfaceForObject, Marshal.GetIUnknownForObjecto Marshal.GetIDispatchForObject per ottenere un IntPtr valore che rappresenta un puntatore all'interfaccia IUnknown . È anche possibile utilizzare 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 di wrapper, vedere COM Callable Wrapper.