iUnknown::AddRef 方法 (unknwn.h)

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

语法

ULONG AddRef();

返回值

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

注解

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

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

呼叫者备注

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

要求

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

另请参阅