共用方式為


IID_PPV_ARGS宏 (combaseapi.h)

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

語法

void IID_PPV_ARGS(
   ppType
);

參數

ppType

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

傳回值

備註

擷取介面指標的方法中常見語法, (最值得注意的是 QueryInterfaceCoCreateInstance) 包含兩個參數:

  • 一般為 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