CComPolyObject::QueryInterface

 

Retrieves a pointer to the requested interface.

Syntax

      STDMETHOD(QueryInterface)(
   REFIID iid,
   void** ppvObject 
);
template <class Q>
HRESULT QueryInterface(Q ** pp);

Parameters

  • Q
    The COM interface.

  • iid
    [in] The identifier of the interface being requested.

  • ppvObject
    [out] A pointer to the interface pointer identified by iid. If the object does not support this interface, ppvObject is set to NULL.

  • pp
    [out] A pointer to the interface identified by __uuidof(Q).

Return Value

A standard HRESULT value.

Remarks

For an aggregated object, if the requested interface is IUnknown, QueryInterface returns a pointer to the aggregated object's own IUnknown and increments the reference count. Otherwise, this method queries for the interface through the CComContainedObject data member, m_contained.

Requirements

Header: atlcom.h

See Also

CComPolyObject Class