c++ - #import 指令创建的 COM 包装器类用 unsigned short 替换 wchar_t

Question

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

#import <msxml6.dll> named_guids

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

例如，ISAXMLReader::putProperty 方法具有以下 signature :

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

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

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());

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

编辑 要添加到困惑中，msxml6.h header 声明了一个具有预期签名的 C++ 类 ISAXMLReader:

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

虽然在阅读了所提供的答案后，我猜它只是隐藏了血淋淋的细节。但至少它与文档一致(在其样本中使用了这个 header 。)

Answer 1

Chris 的评论有一个很好的链接，它非常清楚地描述了问题。总结:

问题是该参数的签名真的是unsigned short *而不是const wchar_t*，尽管 MSDN 一厢情愿地认为相反。

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

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

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

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

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

(我在使用 oleview 方面有很多经验。毕竟，您正在查看代码生成器的输出，就像使用 #import 一样，所以它并不能完全证明任何新内容。但是，这是我们在不使用类型库 API 自己查看类型库的情况下所能做的最好的事情)。

这种事情只是您为使 COM 对象可用于自动化客户端而付出的代价。

附录:

如果您查看界面，您一定想知道您怎么可能调用 that来自 VB6 或 VBScript。出色地。你不能。

SAXXMLReader coclass 实现了两个具有相同语义的近乎孪生的接口(interface):ISAXMLReader 是我们正在查看的接口(interface)，它是一个非远程、非自动化，接口(interface)的 C++ 优化版本。当您使用 VB6 中的 SAXXMLReader 对象时，您得到的是它的 [default] 接口(interface) IVBSAXXMLReader。这是一个继承 IDispatch 的自动化兼容接口(interface)，但它与 ISAXMLReader 具有相同的语义。即:IVBSAXXMLReader 的 putProperty 采用 BSTR 而不是 unsigned short *。

许多类的 MSDN 文档倾向于混淆如何从 C++ 和 VB/VBScript 调用对象之间的区别。它们使您看起来好像在调用相同的东西，而事实并非如此，并且它们将接口(interface)细节隐藏在地毯下。如果他们更明确一点，我会更喜欢。我猜他们必须平衡记录库的语义，并且必须迎合 native 和脚本开发人员，他们在 COM 管道方面的专业知识水平可能大相径庭。