#import指令创建的COM包装类用无符号short替换wchar_t

时间:2014-06-24 23:10:29

标签: c++ com visual-studio-2013 msxml

我们有一些遗留代码使用MSXML和使用Visual Studio的C ++ #import指令生成的包装类,如下所示:

#import <msxml6.dll> named_guids

我们正在升级项目以使用wchar_t作为内置类型(之前设置了/Zc:wchar_t-标记,因此wchar_tunsigned short)。这似乎会导致问题,因为使用#import生成的类型库标头会将const wchar_t*输入参数替换为unsigned short*

例如,ISAXXMLReader::putProperty方法具有以下signature

HRESULT putProperty(
    [in] const wchar_t * pwchName,
    [in] VARIANT varValue);

但生成的类型库标题使用以下签名:

HRESULT ISAXXMLReader::putProperty ( 
    unsigned short * pwchName, 
    const _variant_t & varValue )

所以不仅wchar_t转换为unsigned short,而且const被剥离。因此代码无法编译而没有不雅观的演员:

MSXML2::ISAXXMLReaderPtr saxReader(__uuidof(MSXML2::SAXXMLReader60));
MSXML2::IMXWriterPtr xmlWriter(__uuidof(MSXML2::MXXMLWriter60));

//Set properties on the XML writer.
// Omitted for brevity

saxReader->putProperty(L"http://xml.org/sax/properties/lexical-handler", // Can't convert to unsigned short*
            (_variant_t)xmlWriter.GetInterfacePtr());

有没有办法让import指令在包装类中生成正确的函数签名?

编辑要添加到混乱,msxml6.h标头声明带有预期签名的C ++类ISAXXMLReader

    virtual HRESULT STDMETHODCALLTYPE putProperty( 
        /* [in] */ const wchar_t *pwchName,
        /* [in] */ VARIANT varValue) = 0;

虽然在阅读了所提供的答案之后,我想这只是隐藏了血腥的细节。但至少它与文档一致(在其样本中使用此标题。)

1 个答案:

答案 0 :(得分:2)

克里斯的评论有一个很好的链接,很清楚地描述了这个问题。总结一下:

问题是该参数的签名确实unsigned short *而不是const wchar_t*,尽管MSDN的一厢情愿的想法恰恰相反。

在某种程度上,MSDN中的签名描述了参数的道德意图,而不是其实际签名。

签名是什么的最终权威是MSXML6类型库本身。正如Chris'评论中的链接描述的那样,没有办法在类型库中指出参数是“指向宽字符的指针”,因为自动化不支持这样的事情。因此,他们使用最接近ABI兼容的东西,那就是unsigned short *

#import编译器扩展只能反映类型库中的内容。没有办法告诉它有选择地“撒谎”在输出中。

这是该方法的实际签名,直接取自类型库(通过oleview.exe):

HRESULT _stdcall putProperty(
                  [in] unsigned short* pwchName, 
                  [out, retval] VARIANT* pvarValue);

(使用oleview有一双手掌。毕竟,你正在查看代码生成器的输出,就像#import一样,所以它并没有证明任何新东西。但是,这是我们无法使用类型库API自行查看类型库的最佳方法

这种事情只是您为自动化客户端提供COM对象所付出的代价。

附录:

如果你看一下界面,你不得不想知道你怎么可能从VB6或VBScript调用that。好。你做不到。

SAXXMLReader coclass实现了两个具有相同语义的近似双接口:ISAXXMLReader是我们正在查看的接口,它是一个不可远程,非自动化,C ++优化的版本的界面。从VB6使用SAXXMLReader对象时得到的是[default]接口IVBSAXXMLReader。这是一个IDispatch继承的自动化兼容接口,但它具有与ISAXXMLReader相同的语义。也就是说:IVBSAXXMLReader的{​​{1}}需要putProperty代替BSTR

许多类的MSDN文档往往混淆了如何从C ++和VB / VBScript调用对象之间的区别。它们使得它看起来像是在调用相同的东西,但事实并非如此,并且它们隐藏了地毯下的界面细节。我更愿意,如果他们更明确一点。我猜他们必须记录库的语义,并且必须迎合本地和脚本开发人员,他们可能在COM的管道方面拥有截然不同的专业水平。