阅读量:2
在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 { // 查询接口失败 }