共用方式為

IUnknown_AtomicRelease函式 (shlwapi.h)

  • 發行項

釋放元件物件模型 (COM) 指標，並將其設定為 Null。

語法

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

參數

[in, out, optional] ppunk

類型： void**

COM 介面指標的位址。

傳回值

無

備註

如果 ppunk 指向 Null 指標，則不會執行任何作業。 否則， ppunk 會假設為衍生自 IUnknown的 COM 介面指標位址。 函式會呼叫介面的 IUnknown：：Release 方法，然後將介面指標設定為 Null。

範例

如果資料流程存在，下列範例會使用 IUnknown_AtomicRelease 來釋放資料流程。 如果沒有，則不會執行任何動作。

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

規格需求

   
最低支援的用戶端 Windows 2000 Professional、Windows XP [僅限桌面應用程式]
最低支援的伺服器 Windows 2000 Server、Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 shlwapi.h
Dll Shlwapi.dll (5.0 版或更新版本)