IUnknown::AddRef 方法 (unknwn.h)

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

語法

ULONG AddRef();

傳回值

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

備註

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

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

來電者的附注

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

規格需求

   
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平臺 Windows
標頭 unknwn.h

另請參閱