MULTI_QI 結構 (objidlbase.h)

  • 發行項

表示查詢中多個介面的介面。

語法

typedef struct tagMULTI_QI {
  const IID *pIID;
  IUnknown  *pItf;
  HRESULT   hr;
} MULTI_QI;

成員

pIID

介面識別碼的指標。

pItf

pIID 中要求的介面指標。 此成員在輸入時必須是 NULL 。

hr

QueryInterface 呼叫的傳回值，以找出要求的介面。 常見的傳回值包括S_OK和E_NOINTERFACE。 此成員必須在輸入時為 0。

備註

為了將網路效能優化，大部分遠端啟用函式會採用 MULTI_QI 結構的陣列，而不只是單一 IID 作為輸入，以及物件上要求介面的單一指標做為輸出，就像本機啟用函式一樣。 這可讓介面的一組指標從單一往返伺服器中的相同對象傳回。 在網路案例中，在物件建構時要求多個介面，可節省大量時間，同時針對唯一介面使用 QueryInterface 呼叫，每個介面都需要往返伺服器。

規格需求

需求 值
最低支援的用戶端 Windows 2000 專業版 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows 2000 Server [傳統型應用程式 |UWP 應用程式]
標頭 objidlbase.h (包含 Objidl.h)

另請參閱

CoCreateInstanceEx

CoGetInstanceFromFile

CoGetInstanceFromIStorage

IMultiQI