Rust 调用 Windows 函数，系统级编程的实战指南

本指南详细阐述了在 Rust 环境中调用 Windows 系统函数的方法，是系统级编程的实战教程，内容涵盖了从基础 API 调用到复杂底层交互的关键技术，帮助开发者利用 Rust 的安全特性结合 Windows API，高效实现高性能的桌面应用与系统工具开发。

在 Rust 的生态系统中，虽然语言本身具有极高的安全性，但在处理底层系统操作时，我们往往不可避免地需要与操作系统进行交互，对于 Windows 平台开发者而言，调用 Windows API（应用程序接口）是构建桌面应用、驱动程序或系统工具的核心能力。

本文将深入探讨如何在 Rust 中安全、高效地调用 Windows 函数，涵盖从最现代的“Windows-rs”库到传统的 FFI（外部函数接口）调用的各种方式。

为什么选择 Rust 调用 Windows 函数？

Rust 的内存安全机制与 Windows C++ API 的指针操作形成了互补，使用 Rust 调用 Windows 函数，可以：

Rust 调用 Windows 函数，系统级编程的实战指南

避免内存泄漏：Rust 的借用检查器能确保指针的生命周期管理正确。
跨平台潜力：虽然本文主要讲 Windows，但 Rust 的 FFI 机制也支持跨平台调用。
现代语法：相比 C/C++，Rust 提供了更清晰的错误处理和类型系统。

现代方案：使用 `windows-rs` 库

微软官方维护的 windows-rs 是目前 Rust 调用 Windows API 的首选方案，它自动生成了类型安全的 Rust 绑定，极大降低了使用难度。

添加依赖

在你的 Cargo.toml 中，你需要启用相应的特性，为了演示，我们启用 Win32_UI_WindowsAndMessaging，这包含了 MessageBox 等常用函数。

[dependencies]
windows = { version = "0.52", features = ["Win32_UI_WindowsAndMessaging"] }

编写代码

windows-rs 将 Windows 的函数组织在模块中，使用时，你需要导入具体的函数和结构体。

use windows::Win32::UI::WindowsAndMessaging::*;
fn main() {
    // 使用 MessageBoxW 显示消息框
    // 注意：W 代表 Wide Character (Unicode)，这是 Windows 现在的标准
    let result = unsafe {
        MessageBoxW(
            None, // 父窗口句柄，None 表示无父窗口
            "Hello from Rust!", // 消息内容
            "Rust & Windows API", // 标题
            0, // 消息框类型 (MB_OK)
        )
    };
    // Windows API 通常返回 BOOL，我们可以将其转换为 Rust 的 Result
    if result == 0 {
        eprintln!("Failed to create message box.");
    } else {
        println!("Message box displayed successfully.");
    }
}

优点：