IDispatch接口 - GetIDsOfNames和Invoke

IDispatch接口是COM自动化的核心。其实，IDispatch这个接口本身也很简单，只有4个方法：

 

[cpp]  view plain  copy

 

1. IDispatch : public IUnknown  
2. {  
3. public:  
4.     virtual HRESULT STDMETHODCALLTYPE GetTypeInfoCount(   
5.         /* [out] */ __RPC__out UINT *pctinfo) = 0;  
6.       
7.     virtual HRESULT STDMETHODCALLTYPE GetTypeInfo(   
8.         /* [in] */ UINT iTInfo,  
9.         /* [in] */ LCID lcid,  
10.         /* [out] */ __RPC__deref_out_opt ITypeInfo **ppTInfo) = 0;  
11.       
12.     virtual HRESULT STDMETHODCALLTYPE GetIDsOfNames(   
13.         /* [in] */ __RPC__in REFIID riid,  
14.         /* [size_is][in] */ __RPC__in_ecount_full(cNames) LPOLESTR *rgszNames,  
15.         /* [range][in] */ __RPC__in_range(0,16384) UINT cNames,  
16.         /* [in] */ LCID lcid,  
17.         /* [size_is][out] */ __RPC__out_ecount_full(cNames) DISPID *rgDispId) = 0;  
18.       
19.     virtual /* [local] */ HRESULT STDMETHODCALLTYPE Invoke(   
20.         /* [annotation][in] */   
21.         _In_  DISPID dispIdMember,  
22.         /* [annotation][in] */   
23.         _In_  REFIID riid,  
24.         /* [annotation][in] */   
25.         _In_  LCID lcid,  
26.         /* [annotation][in] */   
27.         _In_  WORD wFlags,  
28.         /* [annotation][out][in] */   
29.         _In_  DISPPARAMS *pDispParams,  
30.         /* [annotation][out] */   
31.         _Out_opt_  VARIANT *pVarResult,  
32.         /* [annotation][out] */   
33.         _Out_opt_  EXCEPINFO *pExcepInfo,  
34.         /* [annotation][out] */   
35.         _Out_opt_  UINT *puArgErr) = 0;  
36.       
37. };  

GetTypeInfoCount和GetTypeInfo以后再说。

 

先来看看比较熟悉的GetIDsOfNames和Invoke。

GetIDsOfNames

这个函数的主要功能就是：把COM接口的方法名字和参数（可选）映射成一组DISPID。DISPID就是一个LONG型：

 

[cpp]  view plain  copy

 

1. typedef LONG DISPID;  

GetIDsOfNames()可以获取方法和属性。先来看一个例子，COM接口IMyCar

 

 

[html]  view plain  copy

 

1. [  
2.     object,  
3.     uuid(21B794E2-4857-4576-8FC2-CDAB2A486600),  
4.     dual,  
5.     nonextensible,  
6.     pointer_default(unique)  
7. ]  
8. interface IMyCar : IDispatch{  
9.     [id(1)] HRESULT Run();  
10.     [id(2)] HRESULT AddGas([in] LONG add, [out] LONG* total);  
11.     [propget, id(3)] HRESULT Gas([out, retval] LONG* pVal);  
12. };  

这个接口里面有一个方法AddGas，它有两个参数，一个输入，一个输出。它的实现基本如下：

 

 

[cpp]  view plain  copy

 

1. STDMETHODIMP CMyCar::AddGas(LONG add, LONG* total)  
2. {  
3.     // TODO: Add your implementation code here  
4.     m_Gas += add;  
5.     *total = m_Gas;  
6.   
7.     return S_OK;  
8. }  

 

 

试试如何获取AddGas函数的id和参数index，看下面的代码。数组里面的第一个元素是方法名字，第二个/第三个是参数名字。

 

[cpp]  view plain  copy

 

1. CComPtr<IMyCar> spCar;  
2. spCar.CoCreateInstance(CLSID_MyCar);  

 

 

[cpp]  view plain  copy

 

1. DISPID PropertyID[3] = {0};  
2. BSTR PropName[3];  
3.       
4. PropName[0] = SysAllocString(L"AddGas");  
5. PropName[1] = SysAllocString(L"add");  
6. PropName[2] = SysAllocString(L"total");  
7. HRESULT hr = spCar->GetIDsOfNames(IID_NULL, PropName, 3, LOCALE_SYSTEM_DEFAULT, PropertyID);  
8.   
9. SysFreeString(PropName[0]);  
10. SysFreeString(PropName[1]);  
11. SysFreeString(PropName[2]);  

运行一下，可以得到如下结果：

 

PropertyID数组里面可以得到3个值：2， 0， 1.

2代表的是AddGas的id，跟idl文件里面的一样。

0表示"add"是第一个参数，1表示"total"是第二个参数。

Invoke

Invoke是IDispatch里面非常重要的一样函数，方法调用就靠这个函数了。函数原型：

 

[cpp]  view plain  copy

 

1. HRESULT Invoke(  
2.   [in]       DISPID dispIdMember,  
3.   [in]       REFIID riid,  
4.   [in]       LCID lcid,  
5.   [in]       WORD wFlags,  
6.   [in, out]  DISPPARAMS *pDispParams,  
7.   [out]      VARIANT *pVarResult,  
8.   [out]      EXCEPINFO *pExcepInfo,  
9.   [out]      UINT *puArgErr  
10. );  

每一个参数的说明，看下面，从MSDN截来的。

 

先来看一个调用例子：

 

[cpp]  view plain  copy

 

1. CComVariant avarParams[2];  
2. avarParams[1].vt = VT_I4;  
3. avarParams[1] = 4;  
4.   
5. LONG vTotal = 0;  
6. avarParams[0].vt = VT_I4 | VT_BYREF;  
7. avarParams[0] = &vTotal;  
8.   
9. DISPPARAMS params = { avarParams,  
10.     NULL,              // Dispatch identifiers of named arguments.   
11.     2,                 // Number of arguments.  
12.     0 };                // Number of named arguments.  
13.   
14. hr = spCar->Invoke(PropertyID[0], IID_NULL, LOCALE_USER_DEFAULT, DISPATCH_METHOD, &params, NULL, NULL, NULL);  

avarParams是一个具有2个元素的数组，它表示要调用的方法的参数，注意这里的参数是逆序的。比如avarParam[1]存放的是第一个参数，是一个输入参数；avarParams[0]存放的是第二个参数，是一个输出参数。

 

运行一下：

spCar里面的m_Gas初始值是0，我们调用的时候给它加了4，那么输出就应该是4.看上面的运行结果，vTotal确实是4.

这样我们就通过Invoke成功调用了COM组件的方法（而不是通过spCar->AddGas）。注意Invoke里面的第一个参数是一个DISPID,这个是从GetIDsOfNames来的。

 

使用Invoke也可以调用COM对象的属性。

比如上面的idl里面的Gas。

调用属性跟方法差不多，如果我们想读取一个属性，那么可以这么调：

 

[cpp]  view plain  copy

 

1. DISPID PropertyID2[1] = { 0 };  
2. BSTR PropName2[1];  
3.   
4. PropName2[0] = SysAllocString(L"Gas");  
5.   
6. hr = spCar->GetIDsOfNames(IID_NULL, PropName2, 1, LOCALE_SYSTEM_DEFAULT, PropertyID2);  
7.   
8. SysFreeString(PropName2[0]);  
9.   
10.   
11. DISPPARAMS params2 = { NULL,  
12.     NULL,  
13.     0,  
14.     0  
15. };  
16.   
17. CComVariant Result;  
18. hr = spCar->Invoke(PropertyID2[0], IID_NULL, LOCALE_USER_DEFAULT, DISPATCH_PROPERTYGET, &params2, &Result, NULL, NULL);  

运行可以得到结果：

 

注意，Invoke的第五个参数啥都没，属性值是从第六个参数返回出来的。如果是方法调用的话，那么COM方法参数需要从第五个参数传进入，第六个参数是函数调用的返回值HRESULT.

我没有试过属性的put，不知道是从哪里传入，当有需要的时候查一下MSDN就行了。

 

以上就是GetIDsOfNames和Invoke的简要说明以及例子。之后再来分析更多的细节。

完整客户端代码：

 

[cpp]  view plain  copy

 

1. // ConsoleApplication4.cpp : Defines the entry point for the console application.  
2. //  
3.   
4. #include "stdafx.h"  
5.   
6. #include <thread>  
7. #include <atlbase.h>  
8. #include <atlcom.h>  
9. #include <algorithm>  
10. #include <vector>  
11. #include <memory>  
12.   
13. #include "../MyCom/MyCom_i.h"  
14. #include "../MyCom/MyCom_i.c"  
15.   
16. int _tmain(int argc, _TCHAR* argv[])  
17. {  
18.     CoInitializeEx(NULL, COINIT_MULTITHREADED);  
19.       
20.     CComPtr<IMyCar> spCar;  
21.     spCar.CoCreateInstance(CLSID_MyCar);  
22.   
23.     // use IDispatch  
24.     DISPID PropertyID[3] = {0};  
25.     BSTR PropName[3];  
26.           
27.     PropName[0] = SysAllocString(L"AddGas");  
28.     PropName[1] = SysAllocString(L"add");  
29.     PropName[2] = SysAllocString(L"total");  
30.     HRESULT hr = spCar->GetIDsOfNames(IID_NULL, PropName, 3, LOCALE_SYSTEM_DEFAULT, PropertyID);  
31.   
32.     SysFreeString(PropName[0]);  
33.     SysFreeString(PropName[1]);  
34.     SysFreeString(PropName[2]);  
35.   
36.     CComVariant avarParams[2];  
37.     avarParams[1].vt = VT_I4;  
38.     avarParams[1] = 4;  
39.   
40.     LONG vTotal = 0;  
41.     avarParams[0].vt = VT_I4 | VT_BYREF;  
42.     avarParams[0] = &vTotal;  
43.   
44.     DISPPARAMS params = { avarParams,  
45.         NULL,              // Dispatch identifiers of named arguments.   
46.         2,                 // Number of arguments.  
47.         0 };                // Number of named arguments.  
48.   
49.     hr = spCar->Invoke(PropertyID[0], IID_NULL, LOCALE_USER_DEFAULT, DISPATCH_METHOD, ¶ms, NULL, NULL, NULL);  
50.       
51.   
52.     DISPID PropertyID2[1] = { 0 };  
53.     BSTR PropName2[1];  
54.   
55.     PropName2[0] = SysAllocString(L"Gas");  
56.       
57.     hr = spCar->GetIDsOfNames(IID_NULL, PropName2, 1, LOCALE_SYSTEM_DEFAULT, PropertyID2);  
58.   
59.     SysFreeString(PropName2[0]);  
60.   
61.   
62.     DISPPARAMS params2 = { NULL,  
63.         NULL,  
64.         0,  
65.         0  
66.     };  
67.       
68.     CComVariant Result;  
69.     hr = spCar->Invoke(PropertyID2[0], IID_NULL, LOCALE_USER_DEFAULT, DISPATCH_PROPERTYGET, ¶ms2, &Result, NULL, NULL);  
70.       
71.     spCar.Release();  
72.   
73.     CoUninitialize();  
74.       
75.     return 0;  
76. }  

相关的COM组件的代码：

 

 

[cpp]  view plain  copy

 

1. 1. STDMETHODIMP CMyCar::AddGas(LONG add, LONG* total)  
   2. {  
   3.     // TODO: Add your implementation code here  
   4.     m_Gas += add;  
   5.     *total = m_Gas;  
   6.   
   7.     return S_OK;  
   8. }  
   9.   
   10.   
   11. STDMETHODIMP CMyCar::get_Gas(LONG* pVal)  
   12. {  
   13.     // TODO: Add your implementation code here  
   14.     *pVal = m_Gas;  
   15.   
   16.     return S_OK;  
   17. }