COM中在声明函数中通常会这样:
HRESULT getName([in]int ID,[out,retval]*BSTR name)
实现函数时,这样:
STDMETHODIMP Person::getName([in]int ID,[out,retval]*BSTR name)
{
........
*name='zhang san';
return S_OK;
}
这里的[out,retval]限定符表示,参数name是作为一个输出参数存在的,且这个参数是作为一个返回值。什么意思呢?
我们知道,对于c++中的普通函数而言,函数计算出来的值是可以直接返回的。但是在COM中,返回值只能是HRESULT类型。这个返回值表示函数运行过程中内部是否发生了错误。
供调用者检查运行是否出错的。那么函数真正的返回值只能以指针的形式返回给由[out]限定的指针类参数了。
但是,我们仍然想在COM中拥有像普通函数那样直接返回返回值的能力怎么办?
[out,retval]限定符修饰的参数就可以使函数直接返回我们所需要的参数。
所以上面的函数可以这么用:
BSTR* name;
name=getName(1617344);
第二个参数直接被返回来了。
注意:1.[out,retval]限定符在一个函数中只能有一个,且必须放置在最后一个参数位置上。
2.无论是[out]还是[out,retval],所修饰的参数必须是指针参数,因为普通参数在函数调用完毕后就被销毁了,并不能得到返回值。
3.个人习惯,能不这么用,尽量别这么用,直接用[out]限定符就可以了。