使用IShellItem与IThumbnailProvider获取缩略图失败（0x80004001未实现）

问题详情 #

用Rust写了一段获取文件缩略图的代码，流程是先通过文件路径获取IShellItem，再尝试绑定IThumbnailProvider，但每次运行都报错：

Failed to get thumbnail provider: Error { code: HRESULT(0x80004001), message: "Not implemented" }

本人是Win32和底层Rust新手，怀疑是内存问题，但找不到具体原因。

相关代码 #

unsafe {
    CoInitialize(None).expect("Failed to initialize COM");

    let item: IShellItem = SHCreateItemFromParsingName(
        w!("J:\\Apps\\Dolphin-x64\\Dolphin.exe"),
        None
    ).expect("Failed to get shell item");

    let thumb_provider: IThumbnailProvider = item
        .BindToHandler(None, &BHID_ThumbnailHandler)
        .expect("Failed to get thumbnail provider");

    let mut icon_bitmap_ref = MaybeUninit::<HBITMAP>::uninit();

    let mut alpha_type = MaybeUninit::<WTS_ALPHATYPE>::uninit();

    let mut icon_bitmap = MaybeUninit::<BITMAP>::uninit();

    thumb_provider
        .GetThumbnail(96, icon_bitmap_ref.as_mut_ptr(), alpha_type.as_mut_ptr())
        .expect("Failed to get thumbnail");
    // Errors right after this

    match
        GetObjectW(
            icon_bitmap_ref.assume_init(),
            std::mem::size_of::<BITMAP>() as i32,
            Some(icon_bitmap.as_mut_ptr().cast())
        )
    {
        0 => panic!("Failed to get bitmap"),
        _ => {
            let icon_image = match alpha_type.assume_init() {
                WTSAT_UNKNOWN => bitmap_to_image(icon_bitmap.assume_init(), true),
                WTSAT_RGB => bitmap_to_image(icon_bitmap.assume_init(), false),
                WTSAT_ARGB => bitmap_to_image(icon_bitmap.assume_init(), true),
                _ => unreachable!("Unknown alpha type"),
            };

            icon_image.save("icon.png").expect("Failed to save icon");
        }
    }

    CoUninitialize();
}

排查与解决思路 #

• BHID类型不匹配：BHID_ThumbnailHandler并非所有文件类型都支持，像EXE这类文件的缩略图通常是通过图标转换而来，而非专用缩略图提供者。可以替换为BHID_Icon，通过IExtractIcon接口获取图标后再转为位图。
• 兼容方案：改用SHGetFileInfo：如果绑定缩略图提供者失败，更简单的方式是用SHGetFileInfo函数直接获取文件图标，这个API兼容性更强，不需要直接操作复杂的COM接口。示例代码片段：

  unsafe {
      let mut shfi = SHFILEINFOW {
          hIcon: std::ptr::null_mut(),
          iIcon: 0,
          dwAttributes: 0,
          szDisplayName: [0; 260],
          szTypeName: [0; 80],
      };
  
      SHGetFileInfoW(
          w!("J:\\Apps\\Dolphin-x64\\Dolphin.exe"),
          0,
          &mut shfi,
          std::mem::size_of::<SHFILEINFOW>() as u32,
          SHGFI_ICON | SHGFI_LARGEICON | SHGFI_USEFILEATTRIBUTES,
      );
  
      // 后续可将shfi.hIcon转为HBITMAP处理保存
      DestroyIcon(shfi.hIcon); // 记得释放资源
  }
  

• 错误逻辑优化：不要直接用expect中断程序，可返回错误码并做降级处理——当BHID_ThumbnailHandler无法获取提供者时，自动切换到图标获取流程。
• 权限与路径检查：确认程序有目标文件的访问权限，路径转义符使用正确（当前代码路径格式没问题）。

内容的提问来源于stack exchange，提问作者Jamzy01