从 dll 返回多个字符串

Question

我们正在讨论什么是从一个 dll 函数返回多个字符串的好方法。目前我们有 8 个字符串，但还会有更多。为简单起见，我现在认为所有字符串的长度都相同。

extern "C" int DLLNAME_ _stdcall GetResult(TestResults* testResults);

在哪里

struct TestResults
{
    int stringLengths;
    char* string1;
    char* string2;
    char* string3;
    char* string4;
    ...
};

或第二个选项：哪里

struct TestResults
{
    int stringLengths;
    char string1[64];
    char string2[64];
    char string3[64];
    char string4[64];
    ...
};

第三个选项： extern "C" int DLLNAME_ _stdcall GetResult(int stringLengths, char* string1, char* string2, char* string3, ...);

dll 将通过串行线路进行通信并检索将填充到字符串中的信息。需要分配内存的地方有待讨论，可以作为答案的一部分。

背景是我们有一个喜欢第二种方法的 VB6 应用程序团队和一个喜欢第一种方法的 C++/C# 团队。最后一种方法看起来适合两个团队，但对我来说有这么多参数看起来有点奇怪。

也许还有更多选择。 Windows下的常见做法是什么？来自 Windows API 的任何示例或用于选择其中一个的参数？

编辑：字符串的含义与名字、姓氏、电子邮件一样。我们目前有八个，但将来我们可能会添加一对，例如地址。数组不是正确的选择，但从原始上下文中并不清楚。

Answer 1

最好的方法可能是使用一个安全数组来存储BSTR 字符串。

VB 和 C# 都非常了解安全数组：在 C# 中，BSTR 字符串的安全数组会自动转换为string[] 数组。

在 C++ 方面，您可以使用 ATL::CComSafeArray 帮助类来简化安全数组编程。

您会在this MSDN Magazine article 中找到有趣的材料（特别是，请查看段落生产一个安全的字符串数组）。

---

从上述文章中：在 C++ 端，您可以实现一个 C 接口 DLL，导出如下函数：

extern "C" HRESULT MyDllGetStrings(/* [out] */ SAFEARRAY** ppsa)
{
  try {  
    // Create a SAFEARRAY containing 'count' BSTR strings
    CComSafeArray<BSTR> sa(count);

    for (LONG i = 0; i < count; i++) {
      // Use ATL::CComBSTR to safely wrap BSTR strings in C++
      CComBSTR bstr = /* your string, may build from std::wstring or CString */ ;

      // Move the the BSTR string into the safe array
      HRESULT hr = sa.SetAt(i, bstr.Detach(), FALSE);

      if (FAILED(hr)) {
        // Error...
        return hr;
      }
    }

    // Return ("move") the safe array to the caller
    // as an output parameter (SAFEARRAY **ppsa)
    *ppsa = sa.Detach();

  } catch (const CAtlException& e) {
    // Convert ATL exceptions to HRESULTs
    return e;
  }

  // All right
  return S_OK;
}

在 C# 端，您可以使用此 PInvoke 声明：

[DllImport("MyDll.dll", PreserveSig = false)]
public static extern void MyDllGetStrings(
  [Out, MarshalAs(UnmanagedType.SafeArray, SafeArraySubType = VarEnum.VT_BSTR)]
  out string[] result);

Answer 2

当您将函数声明为 extern "C" 时，我想您不能使用 std::vector<std::string> 作为返回类型。

另一种可能是：

struct String
{
   int         size; /* size of string */
   const char* str;  /* actual string  */
}
struct TestResults
{
   int     size; /* number of strings             */
   String* arr;  /* pointer to an array of String */
};

然后和之前一样：

extern "C" int DLLNAME_ _stdcall GetResult(TestResults* testResults);

这样，您可以灵活地返回任意数量的字符串。还可以轻松循环您的TestResults。

编辑 #1： 如 cmets 所述：使用 BSTR。所以你的结构看起来像：

struct TestResults
{
   int   size; /* number of strings           */
   BSTR* arr;  /* pointer to an array of BSTR */
};

BSTR 将通过：BSTR MyBstr = SysAllocString(L"I am a happy BSTR"); 变为 allocated。此分配还设置包含字符串长度的成员。您必须使用以下命令释放分配的内存：SysFreeString(MyBstr);。您还需要分配整个数组BSTR*。