CComPolyObject::QueryInterface

  • Article

Retrieves a pointer to the requested interface.

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

Reference

CComPolyObject Class