IUnknown::QueryInterface 메서드

개체가 특정의 구성 요소 개체 모델 (COM) 인터페이스를 지원 하고 있을지 어떨지를 판별한다. 인터페이스가 지원 되고 있는 경우, 시스템은 개체의 참조 카운트를 늘려, 애플리케이션은, 그 인터페이스를 곧바로 사용할 수 있다.

구문

HRESULT QueryInterface(      

    REFIID riid,
    LPVOID *ppvObj
);

파라미터

riid

요구하는 인터페이스의 참조 식별자.

ppvObj

목적의 인터페이스가 지원 되고 있는 경우에, 인터페이스의 포인터가 저장 되는 포인터 변수의 주소.

반환값

성공했을 경우는, S_OK 를 돌려준다.

실패했을 경우는, E_NOINTERFACE 또는 E_POINTER 를 돌려준다. 구성 요소에는, 이러한 에러값에 대한 독자적인 정의를 헤더 파일에 저장 하고 있는 것도 있다. 예를 들어, Microsoft® DirectInput® 에서는 DIERR_NOINTERFACE 는 E_NOINTERFACE 에 동일하다.

주의

이 메서드의 호출에 의해 취득한 인터페이스를 사용할 필요가 없는 경우는, 그 인터페이스의 IUnknown::Release 메서드를 호출해 인터페이스를 릴리즈 해야 한다. IUnknown::QueryInterface 메서드에 의해, Microsoft 및 써드파티 각사는, 기능을 방해하는 일 없이 개체를 확장할 수 있다.