Metodo IUnknown::AddRef (unknwn.h)

  • Articolo

Incrementa il conteggio dei riferimenti per un puntatore dell'interfaccia a un oggetto COM. È consigliabile chiamare questo metodo ogni volta che si esegue una copia di un puntatore dell'interfaccia

Sintassi

ULONG AddRef();

Valore restituito

Il metodo restituisce il nuovo conteggio dei riferimenti. Questo valore deve essere usato solo a scopo di test.

Commenti

Un oggetto COM usa un meccanismo di conteggio dei riferimenti per interfaccia per garantire che l'oggetto non vi faccia riferimento. Si usa AddRef per stabilizzare una copia di un puntatore dell'interfaccia. Può anche essere chiamato quando la vita di un puntatore clonato deve estendersi oltre la durata del puntatore originale. Il puntatore clonato deve essere rilasciato chiamando IUnknown::Release .

Il contatore di riferimento interno gestito da AddRef deve essere un intero senza segno a 32 bit.

Note per i chiamanti

Chiamare questo metodo per ogni nuova copia di un puntatore dell'interfaccia creato. Ad esempio, se si restituisce una copia di un puntatore da un metodo, è necessario chiamare AddRef in tale puntatore . È anche necessario chiamare AddRef in un puntatore prima di passarlo come parametro in-out a un metodo; il metodo chiamerà IUnknown::Release prima di copiare il valore out-value sopra di esso.

Requisiti

   
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione unknwn.h

Vedi anche