Share via

IID_PPV_ARGS宏 (combaseapi.h)

  • 發行項

用來擷取介面指標，根據所使用的介面指標類型自動提供所要求介面的 IID 值。 這可藉由檢查在編譯時期傳遞的值類型，來避免常見的編碼錯誤。

語法

void IID_PPV_ARGS(
   ppType
);

參數

ppType

介面指標的位址，其類型 T 是用來判斷所要求物件的型別。 宏會透過此參數傳回介面指標。

傳回值

無

備註

擷取介面指標的方法中常見語法， (最值得注意的是 QueryInterface 和 CoCreateInstance) 包含兩個參數：

  • 一般為 REFIID 類型的 [in] 參數，指定要擷取之介面的 IID。
  • 一般為 void 類型的 [out] 參數，可接收介面指標。
此宏會根據介面指標的類型來計算 IID，以防止 IID 和介面指標類型不相符的編碼錯誤。 Windows 開發人員應該一律將此宏與任何需要個別 IID 和介面指標參數的方法搭配使用。

雖然 Windows 7 是公用標頭中第一個包含此宏，但它可以在較舊的系統上手動定義它，或在您的項目標頭或原始程式碼中加以定義。

下列範例示範如何使用 IPropertyStore 建立記憶體屬性存放區物件IID_PPV_ARGS。

IPropertyStore *pPropertyStore;

CoCreateInstance(CLSID_PropertyStore, NULL, CLSCTX_INPROC_SERVER, IID_PPV_ARGS(&pPropertyStore));

規格需求

需求 值
最低支援的用戶端 Windows 7 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 R2 [僅限傳統型應用程式]
目標平台 Windows
標頭 combaseapi.h