C#封装STMCubeProgrammer API调用getStLinkList无响应求助

我正在尝试用C#封装STM32CubeProgrammer的公开DLL API，该库配有头文件、文档和C示例。C示例能正常连接、读写目标设备，但封装第一个函数getStLinkList后，调用完全没效果：

C++示例核心代码 #

debugConnectParameters *stLinkList;
int getStlinkListNb = getStLinkList(&stLinkList, 0);

DLL头文件定义 #

int getStLinkList(debugConnectParameters** stLinkList, int shared);

连接1个STLink时，C++中getStlinkListNb返回1。

我的C# DllImport代码 #

[DllImport(@"C:\Program Files\STMicroelectronics\STM32Cube\STM32CubeProgrammer\api\lib\CubeProgrammer_API.dll")]
public static extern int getStLinkList(ref IntPtr stLinkList, int shared);

测试代码 #

IntPtr list = IntPtr.Zero;
var count = CubeProgrammerAPI.getStLinkList(ref list ,0);

调用后count为0，list仍为IntPtr.Zero，无任何错误提示。我尝试过使用out、In/Out属性，以及unsafe指针方式：

Unsafe方式的DllImport #

[DllImport(@"C:\Program Files\STMicroelectronics\STM32Cube\STM32CubeProgrammer\api\lib\CubeProgrammer_API.dll")]
public static unsafe extern int getStLinkList(debugConnectParameters** stLinkList, int shared);

Unsafe测试代码 #

CubeProgrammerAPI.debugConnectParameters *dbgParams;
var count = CubeProgrammerAPI.getStLinkList(&dbgParams, 0);

也尝试过安全代码中使用结构体数组的ref方式，但均无效果，且无任何错误。这种无报错但功能失效的情况正常吗？如何解决该问题？

• 修正调用约定：C++默认调用约定为cdecl，而C#的DllImport默认是StdCall，栈不平衡会导致函数静默失效。修改DllImport指定调用约定：

  [DllImport(@"CubeProgrammer_API.dll", CallingConvention = CallingConvention.Cdecl, CharSet = CharSet.Ansi)]
  public static extern int getStLinkList(ref IntPtr stLinkList, int shared);
  

• 对齐结构体定义：debugConnectParameters的C#结构体必须与C版本完全匹配，包括字段顺序、类型、内存对齐。添加[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Ansi)]特性，确保类型映射正确（比如C的char*对应C#的IntPtr或string，int对应int）。
• 匹配平台位数：确保C#程序的目标平台（x86/x64）与CubeProgrammer_API.dll的位数一致，STM32CubeProgrammer的API分32位和64位版本，位数不匹配会导致静默失败。
• 检查API初始化：部分DLL需要前置初始化调用，查阅CubeProgrammer文档，确认是否存在如InitAPI之类的初始化函数，需在调用getStLinkList前执行。
• 提升程序权限：以管理员身份运行C#程序，USB设备枚举可能需要更高权限才能正常执行。

内容的提问来源于stack exchange，提问作者user6330997