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이어야 합니다.

설명

네트워크 성능을 최적화하기 위해 대부분의 원격 활성화 함수는 단일 IID가 아닌 MULTI_QI 구조의 배열을 입력으로 사용하고 로컬 활성화 함수와 마찬가지로 개체의 요청된 인터페이스에 대한 단일 포인터를 출력으로 사용합니다. 이렇게 하면 인터페이스에 대한 포인터 집합을 서버로의 단일 왕복에서 동일한 개체에서 반환할 수 있습니다. 네트워크 시나리오에서 개체 생성 시 여러 인터페이스를 요청하면 고유한 인터페이스에 대해 QueryInterface 에 대한 여러 호출을 사용하여 상당한 시간을 절약할 수 있으며, 각 인터페이스는 서버로 왕복해야 합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 2000 Professional [데스크톱 앱 | UWP 앱]
지원되는 최소 서버 Windows 2000 Server [데스크톱 앱 | UWP 앱]
머리글 objidlbase.h(Objidl.h 포함)

추가 정보

CoCreateInstanceEx

CoGetInstanceFromFile

CoGetInstanceFromIStorage

IMultiQI