funzione IUnknown_AtomicRelease (shlwapi.h)

Articolo
08/26/2023

Rilascia un puntatore COM (Component Object Model) e lo imposta su NULL.

Sintassi

void IUnknown_AtomicRelease(
  [in, out, optional] void **ppunk
);

Parametri

[in, out, optional] ppunk

Tipo: void**

Indirizzo di un puntatore a un'interfaccia COM.

Valore restituito

nessuno

Osservazioni

Se ppunk punta a un puntatore NULL , non viene eseguita alcuna operazione. In caso contrario, si presuppone che ppunk sia l'indirizzo di un puntatore dell'interfaccia COM, derivato da IUnknown. La funzione chiama il metodo IUnknown::Release dell'interfaccia, quindi imposta il puntatore dell'interfaccia su NULL.

Esempio

L'esempio seguente usa IUnknown_AtomicRelease per rilasciare il flusso, se presente. In caso contrario, non fa niente.

void sample()
{
    IStream *pstm = NULL;
    CreateStreamOnHGlobal(NULL, TRUE, &pstm);
    
    IUnknown_AtomicRelease((void**)&pstm);
    
    // At this point, pstm is NULL
}

Requisiti


Client minimo supportato	Windows 2000 Professional, Windows XP [solo app desktop]
Server minimo supportato	Windows 2000 Server, Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shlwapi.h
DLL	Shlwapi.dll (versione 5.0 o successiva)

Condividi tramite