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 专业版、Windows XP [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server、Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 shlwapi.h
DLL Shlwapi.dll (5.0 或更高版本)