Metodo IUnknown::Release (unknwn.h)

  • Articolo

Decrementa il conteggio dei riferimenti per un'interfaccia in un oggetto COM.

Sintassi

ULONG Release();

Valore restituito

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

Commenti

Quando il conteggio dei riferimenti su un oggetto raggiunge zero, Release deve liberare il puntatore dell'interfaccia. Quando il puntatore rilasciato è l'unico riferimento in sospeso (in precedenza) a un oggetto (indipendentemente dal fatto che l'oggetto supporti interfacce singole o multiple), l'implementazione deve liberare l'oggetto.

Si noti che l'aggregazione di oggetti limita la possibilità di ripristinare i puntatori di interfaccia.

Note per i chiamanti

Chiamare questo metodo quando non è più necessario usare un puntatore all'interfaccia. Se si sta scrivendo un metodo che accetta un parametro in uscita, chiamare Release sul puntatore passato prima di copiare il valore out su di esso.

Requisiti

Requisito Valore
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