Share via


IUnknown::AddRef 方法 (unknwn.h)

遞增 COM 物件的介面指標參考計數。 每當建立介面指標的複本時,您應該呼叫這個方法

Syntax

ULONG AddRef();

傳回值

方法會傳回新的參考計數。 此值僅供測試之用。

備註

COM 物件會使用個別介面參考計數機制,以確保物件不會逾時參考該物件。 您可以使用 AddRef 穩定介面指標的複本。 當複製指標的存留期必須超過原始指標的存留期時,也可以呼叫它。 複製的指標必須藉由在它上呼叫 IUnknown::Release 來釋放。

AddRef維護的內部參考計數器應該是 32 位不帶正負號的整數。

來電者附注

針對您所建立之介面指標的每個新複本,呼叫這個方法。 例如,如果您從方法傳回指標的複本,則必須在該指標上呼叫 AddRef 。 您也必須在指標上呼叫 AddRef ,才能將它當做輸出參數傳遞至方法;方法會先呼叫 IUnknown::Release ,再複製其上的 out 值。

需求

   
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 unknwn.h

另請參閱