fungsi IUnknown_AtomicRelease (shlwapi.h)

Artikel
08/26/2023

Merilis penunjuk Model Objek Komponen (COM) dan mengaturnya ke NULL.

Sintaks

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

Parameter

[in, out, optional] ppunk

Jenis: void**

Alamat penunjuk ke antarmuka COM.

Menampilkan nilai

Tidak ada

Keterangan

Jika ppunk menunjuk ke pointer NULL , tidak ada operasi yang dilakukan. Jika tidak, ppunk diasumsikan sebagai alamat penunjuk antarmuka COM, berasal dari IUnknown. Fungsi ini memanggil metode IUnknown::Release antarmuka kemudian mengatur penunjuk antarmuka ke NULL.

Contoh

Contoh berikut menggunakan IUnknown_AtomicRelease untuk merilis aliran, jika ada. Jika tidak, itu tidak melakukan apa-apa.

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

Persyaratan


Klien minimum yang didukung	Windows 2000 Professional, Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server, Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	shlwapi.h
DLL	Shlwapi.dll (versi 5.0 atau yang lebih baru)

Bagikan melalui