在C++中,QueryInterface函数主要用于实现COM接口的查询功能。它通常用于在一个对象中查询指定的接口是否存在,并获取该接口的指针。

接口的定义类似于以下形式:

class IInterface{public:    virtual HRESULT queryInterface(REFIID riid, void** ppv) = 0;    // 其他接口方法...};

其中,queryInterface函数需要传入一个REFIID参数,表示要查询的接口的唯一标识符。另外,还需要传入一个void** ppv参数,表示用于接收查询到的接口指针的地址。

在类的实现中,queryInterface函数实现如下:

HRESULT MyClass::queryInterface(REFIID riid, void** ppv){    if (riid == IID_IInterface) // IID_IInterface为待查询接口的唯一标识符    {        *ppv = static_cast<IInterface*>(this);        AddRef(); // 如果查询成功,需要增加引用计数        return S_OK; // 返回成功标志    }    else    {        *ppv = nullptr; // 如果查询失败,将接口指针置为空        return E_NOINTERFACE; // 返回接口不存在的错误代码    }}

在使用QueryInterface函数时,可以通过类的指针调用该函数,并传入待查询接口的唯一标识符和接收接口指针的地址。如果查询成功,QueryInterface函数会返回S_OK,同时将接口指针赋值给ppv所指向的地址;如果查询失败,QueryInterface函数会返回E_NOINTERFACE,并将接口指针置为空。

示例代码如下:

IInterface* pInterface = nullptr;HRESULT hr = myObject->queryInterface(IID_IInterface, reinterpret_cast<void**>(&pInterface));if (SUCCEEDED(hr)){    // 成功获取接口指针,可以使用pInterface调用接口方法}else{    // 查询接口失败}