_com_ptr_t 類別
Microsoft 特定的
_com_ptr_t 物件會封裝 COM 介面指標,並稱為「智慧」指標。 此範本類別會透過對成員函式的函式呼叫 IUnknown
來管理資源配置和解除配置: QueryInterface
、 AddRef
和 Release
。
智慧型指標通常是由_COM_SMARTPTR_TYPEDEF宏所提供的 typedef 定義所參考。 這個宏會採用介面名稱和 IID,並宣告具有 介面名稱加上 尾碼 Ptr
的 _com_ptr_t 特製化 。 例如:
_COM_SMARTPTR_TYPEDEF(IMyInterface, __uuidof(IMyInterface));
宣告_com_ptr_t 特製化 IMyInterfacePtr
。
一組 函式範本 ,而非此範本類別的成員,支援與比較運算子右側智慧型指標的比較。
營造
名稱 | 描述 |
---|---|
_com_ptr_t | 建構_com_ptr_t 物件。 |
低階作業
名稱 | 描述 |
---|---|
AddRef | 在 AddRef 封裝的介面指標上呼叫 的成員函 IUnknown 式。 |
附加 | 封裝這個智慧型指標類型的一般介面指標。 |
CreateInstance | 指定 或 ProgID ,建立 物件 CLSID 的新實例。 |
卸離 | 擷取和傳回封裝的介面指標。 |
GetActiveObject | 附加至指定 CLSID 或 ProgID 之物件的現有實例。 |
GetInterfacePtr | 傳回封裝的介面指標。 |
QueryInterface | 在 QueryInterface 封裝的介面指標上呼叫 的成員函 IUnknown 式。 |
版本 | 在 Release 封裝的介面指標上呼叫 的成員函 IUnknown 式。 |
操作員
名稱 | 描述 |
---|---|
operator = | 將新值指派給現有的 _com_ptr_t 物件。 |
運算子 ==、!=、、 <> 、 < =、 > = | 比較智慧型指標物件與另一個智慧型指標、原始介面指標或 Null。 |
擷取 | 擷取封裝的 COM 介面指標。 |
END Microsoft 特定的
需求
Header: < comip.h>
Lib: comsuppw.lib 或 comsuppwd.lib (如需詳細資訊,請參閱 /Zc:wchar_t (wchar_t 為原生類型)
另請參閱
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應