如何正确使用com.sun.jna.examples.win32进行Windows API调用？

Question

在使用 `com.sun.jna.examples.win32` 进行 Windows API 调用时，常见的一个技术问题是：**如何正确映射 Windows API 函数参数与返回类型，以避免内存泄漏或程序崩溃？** 该问题的核心在于理解 JNA（Java Native Access）如何将 Java 类型映射到 Win32 API 所需的本地类型（如 HANDLE、DWORD、LPSTR 等），并正确声明接口方法。例如，错误地使用 `int` 代替 `WString` 或 `Pointer` 可能导致访问非法内存地址。此外，未正确释放由 API 分配的资源（如 `LocalFree` 或 `GlobalFree`）也可能引发内存泄漏。 掌握 JNA 的类型映射规则、合理使用结构体对齐（Structure）、回调函数（Callback）以及异常处理机制，是确保调用稳定性和安全性的关键所在。