java - JNA映射以将输入/输出缓冲区传递给winapi函数

Question

我需要在适用于 Windows 的 Java 应用程序中枚举指向文件的硬链接(hard link)。我考虑过将运行时与 fsutil hardlink list 一起使用，但需要管理权限。这让我想到了 WINAPI(呃)。 Kernel32.dll 函数，FindFirstFileNameW和 FindNextFileNameW应该这样做，但我无法通过 JNA API 调用它。 FindFirstFileNameW 具有规范:

HANDLE WINAPI FindFirstFileNameW(
 _In_     LPCWSTR lpFileName,
 _In_     DWORD dwFlags,
 _Inout_  LPDWORD StringLength,
 _Inout_  PWCHAR LinkName
);

我的 JNA 映射:

public interface Kernel32 extends StdCallLibrary { 
    Kernel32 INSTANCE = (Kernel32)Native.loadLibrary("kernel32",Kernel32.class, W32APIOptions.UNICODE_OPTIONS);
    HANDLE FindFirstFileNameW(WString wString, int dwFlags, IntByReference StringLength, ______ LinkName);

    boolean FindNextFileNameW(HANDLE hFindStream, IntByReference StringLength, ______ LinkName);
    boolean FindClose(HANDLE hFindFile);
    int GetLastError();
}

调用函数的相关部分:

public String[] getHardLInks(Path path)
{
  Kernel32 lib = Kernel32.INSTANCE;
  IntByReference stringLength = new IntByReference();
  ______ linkName = ______;
  HANDLE hFile = lib.FindFirstFileNameW(new WString(path.toString()), 0, stringLength, linkName);
  String hardlink = //Convert linkName to String
  //Add to array
  // Loop through FindNextFileName
  //Close handle
}

空白处是我尝试映射 LinkName 的地方，“指向缓冲区的指针，用于存储为 lpFileName 找到的第一个链接名称”，但未成功.这包括字符串、char[]、byte[]、Buffer、Pointer 和 Memory，但调用不会返回任何结果。我相信其余的从我在测试中从 StringLength 获得的返回值是正确的。但是，GetLastError 总是返回 ERROR_MORE_DATA (234)，根据文档，这意味着缓冲区太小，即使我传入了千字节的内存。

我应该使用什么数据类型以及如何将其恢复为字符串？

Answer 1

PWCHAR => char[]，尽管 NIO 缓冲区或内存也可以工作(请记住缓冲区和内存以字节为单位计数，而 API 期望以字符计数)。

您还需要将 IntByReference 初始化为数组的大小，否则您就是在告诉 API 您的缓冲区大小为零，它会乖乖地用零个字符填充缓冲区.

像大多数此类 MS API 函数一样，您可以为缓冲区传递 null，然后它将所需的缓冲区大小写入您的长度引用。

编辑

另一件事 - 由于您(正确地)使用 W32API_UNICODE_OPTIONS 来初始化您的库映射，String 现在将自动映射到宽字符串(因此您不需要不必使用 WString)，-A/W 函数后缀会自动处理，因此您可以删除 -W方法名称的后缀。