如何在Dart win32包中正确调用ExtractAssociatedIcon函数

针对你遇到的piIcon参数传递问题，核心点是这个参数是输出参数——函数需要向你提供的内存地址写入图标索引，而不是直接接收一个整数值。以下是正确的调用步骤和代码示例：

关键原理 #

Pointer<Uint16>类型的参数要求你提供一块能存储16位无符号整数的内存空间，函数执行后会把图标索引写入这块内存。你不需要用Pointer.fromAddress，直接分配一块新的内存即可。

完整调用示例 #

import 'dart:ffi';
import 'package:win32/win32.dart';

int getFileAssociatedIconIndex(String fullFilePath) {
  // 获取当前应用的模块句柄
  final hInstance = GetModuleHandle(nullptr);
  // 将文件路径转换为Win32所需的UTF-16指针
  final filePathPtr = fullFilePath.toNativeUtf16();
  // 分配一块Uint16类型的内存，用于接收函数返回的图标索引
  final iconIndexPtr = calloc<Uint16>();

  try {
    // 调用ExtractAssociatedIcon函数
    final iconHandle = ExtractAssociatedIcon(hInstance, filePathPtr, iconIndexPtr);
    
    if (iconHandle == 0) {
      // 调用失败，可根据需要添加错误处理逻辑
      return -1;
    }

    // 从分配的内存中读取图标索引值
    final iconIndex = iconIndexPtr.value;
    
    // 注意：如果需要使用返回的iconHandle（图标句柄），后续记得用DestroyIcon释放
    // DestroyIcon(iconHandle);
    
    return iconIndex;
  } finally {
    // 必须释放所有分配的原生内存，避免泄漏
    calloc.free(filePathPtr);
    calloc.free(iconIndexPtr);
  }
}

重要注意事项 #

• 内存管理：所有用toNativeUtf16()和calloc分配的原生内存，必须在使用完后释放，否则会造成内存泄漏，finally块是最安全的释放位置。
• 图标句柄处理：如果你的需求不仅是获取索引，还要显示图标，需要用DestroyIcon()释放ExtractAssociatedIcon返回的图标句柄，避免GDI资源泄漏。
• 跨平台局限：这个方案仅适用于Windows，如果你后续需要支持Linux和macOS，还需要分别实现对应平台的图标获取逻辑（比如Linux用freedesktop的图标主题API，macOS用AppKit的NSWorkspace）。

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