IUnknown::AddRef 方法 (unknwn.h)

递增指向 COM 对象的接口指针的引用计数。 每当创建接口指针的副本时,都应调用此方法

语法

ULONG AddRef();

返回值

该方法返回新的引用计数。 此值仅用于测试目的。

注解

COM 对象使用每接口引用计数机制来确保该对象不具有对该对象的引用。 使用 AddRef 稳定接口指针的副本。 克隆指针的生存期必须超出原始指针的生存期时,还可以调用它。 克隆的指针必须通过调用 IUnknown::Release 来释放。

AddRef 维护的内部引用计数器应为 32 位无符号整数。

对呼叫者的说明

针对所创建的接口指针的每个新副本调用此方法。 例如,如果从方法返回指针的副本,则必须在该指针上调用 AddRef 。 在将 AddRef 作为输出参数传递给方法之前,还必须在指针上调用 AddRef ;该方法将在上面复制输出值之前调用 IUnknown::Release

要求

   
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 unknwn.h

另请参阅