Windows-rs项目中SHOpenFolderAndSelectItems的正确使用方法

在Windows系统编程中，经常需要实现"在资源管理器中选中并打开指定文件"的功能。Windows API提供了SHOpenFolderAndSelectItems函数来实现这一功能，但在使用过程中需要注意一些关键细节。

常见问题分析

许多开发者在尝试使用SHOpenFolderAndSelectItems时会遇到STATUS_ACCESS_VIOLATION错误。这通常是由于参数传递不正确导致的，特别是当使用IShellFolder::ParseDisplayName方法获取ITEMIDLIST结构时。

正确实现方式

Windows-rs项目提供了更简洁的替代方案，使用ILCreateFromPathW函数可以直接从路径创建ITEMIDLIST：

use windows::{
    core::w,
    Win32::{
        System::Com::CoInitialize,
        UI::Shell::{Common::ITEMIDLIST, ILCreateFromPathW, ILFree, SHOpenFolderAndSelectItems},
    },
};

fn main() -> windows::core::Result<()> {
    unsafe {
        CoInitialize(None).ok()?;
        let root_idl = ILCreateFromPathW(w!(r#"C:\Windows"#));
        let idls: [*const ITEMIDLIST; 2] = [
            ILCreateFromPathW(w!(r#"C:\Windows\Assembly"#)),
            ILCreateFromPathW(w!(r#"C:\Windows\Boot"#)),
        ];
        SHOpenFolderAndSelectItems(root_idl as _, Some(&idls), 0)?;
        
        // 记得释放ITEMIDLIST
        ILFree(root_idl as _);
        for idl in idls {
            ILFree(idl as _);
        }
    }
    Ok(())
}

使用ParseDisplayName的注意事项

如果确实需要使用IShellFolder::ParseDisplayName方法，必须正确处理指针的间接层级：

let mut dir_item: *mut ITEMIDLIST = std::ptr::null_mut();
unsafe {
    desktop.ParseDisplayName(
        HWND::default(),
        None,
        PCWSTR::from_raw(dir.as_ptr()),
        None,
        &mut dir_item,  // 注意这里需要传递指针的指针
        0 as _,
    )?;
}

关键点总结

1. COM初始化：使用前必须调用CoInitialize初始化COM库
2. 路径转换：使用ILCreateFromPathW比ParseDisplayName更简单直接
3. 内存管理：使用ILFree释放创建的ITEMIDLIST结构
4. 指针处理：特别注意ParseDisplayName需要指针的指针作为输出参数
5. 字符串处理：对于运行时字符串，可以使用HSTRING::from()进行转换

通过遵循这些最佳实践，可以避免常见的访问冲突错误，实现稳定可靠的文件夹和文件选择功能。