windows-rs

说明

windows-rs 用于在 Rust 中调用 Windows API, WinRT API 和相关系统类型.
本页聚焦一个常见的字符串传参与返回值转换场景: String -> HSTRING -> PCWSTR.
若你在排查 FFI 或平台绑定问题, 也可以结合 Rust 问题汇总一起看.

适用场景

在 Rust 桌面程序中调用 Windows Shell, 窗口, 文件系统等系统 API.
需要把 Rust 字符串安全地转换为 Windows 侧常见的 UTF-16 表示.
需要从返回的宽字符串结果再转回 Rust 侧可用的文本类型.

常见依赖

[dependencies]
windows = { version = "0.62", features = [
  "Win32_UI_Shell",
  "Win32_Foundation",
] }

实际 features 需要按目标 API 所在模块启用.
若编译时报模块未找到, 首先检查 features 是否覆盖到对应命名空间.

示例: 设置与读取 AppUserModelID

#![allow(unused)]
fn main() {
use std::ffi::OsString;
use std::os::windows::ffi::OsStringExt;
use windows::core::{HSTRING, PCWSTR};
use windows::Win32::UI::Shell;

pub fn set_current_process_explicit_app_user_model_id() {
    let app_id = HSTRING::from("EhExt");

    unsafe {
        match Shell::SetCurrentProcessExplicitAppUserModelID(PCWSTR::from_raw(app_id.as_ptr())) {
            Ok(_) => {
                log::info!("SetCurrentProcessExplicitAppUserModelID ok");
            }
            Err(error) => {
                log::info!("SetCurrentProcessExplicitAppUserModelID error: {error}");
            }
        }
    }
}

pub fn get_current_process_explicit_app_user_model_id() {
    unsafe {
        match Shell::GetCurrentProcessExplicitAppUserModelID() {
            Ok(value) => {
                let value = OsString::from_wide(value.as_wide())
                    .to_string_lossy()
                    .into_owned();
                log::info!("GetCurrentProcessExplicitAppUserModelID: {value}");
            }
            Err(error) => {
                log::info!("GetCurrentProcessExplicitAppUserModelID error: {error}");
            }
        }
    }
}
}