Metodo IUnknown::Release (unknwn.h)
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 |