在 COM 中使用成功的 HRESULT

Question

我在 COM 接口中有一些函数通过 HRESULT 返回不同的成功值，但使用定义为“成功”的空间（即SUCCEEDED(hr) 非零）。

例如

HRESULT MyMessageBox( BSTR title /*[in]*/, BSTR text /*[in]*/, long buttons /*[in]*/ );

显示类似于 MessageBox 的对话框的函数；它返回用户用来关闭对话框的按钮的指示符。 （我为此定义了一个枚举，其值位于 HRESULT 空间内，为用户定义的代码保留）。

这在 C++ 客户端中很好；但是，当 VB 是客户端或 Java 包装器（例如 JACOB）时，它似乎会拦截 HRESULT，并且客户端无法判断发生了哪些成功的代码。

让 HRESULT 指示除0 或异常之外的任何内容实际上是一种糟糕的设计吗？我应该改为创建具有[out] 参数的新函数来获取使用哪个按钮？

Answer 1

大多数语言运行时都会将 HRESULT 映射到异常，这使得编写 COM 代码更加容易。是的，他们会忽略积极的价值观。他们可能对此有一个转义，在 .NET 中，[PreserveSig] 属性抑制异常映射并将 HRESULT 返回值公开为 int。

但这很痛苦，也没有必要。它们还会将您装饰为 [out, retval] 的参数映射到函数返回值。这是您在此处寻找的内容：

HRESULT MyMessageBox([in] BSTR title, [in] BSTR text, [in] long buttons,
                     [out,retval] long* result);

现在客户端程序员可以这样写：

int result = yadayada.MyMessageBox("title", "text", 0);

让您有机会将 HRESULT 仅用于“函数失败”返回值，否则为 S_OK。您可以通过使用 enum 类型来命名合法按钮并返回值来进一步改进它。