使用Go语言调用Windows API获取字体目录-Golang-PHP中文网

使用Go语言调用Windows API获取字体目录

碧海醫心

发布： 2025-10-23 12:20:19

原创

484人浏览过

使用go语言调用windows api获取字体目录

本文详细介绍了如何在Go语言中通过调用Windows API `SHGetKnownFolderPath`来准确获取系统字体目录。文章涵盖了`GUID`结构体的定义、`syscall`包的使用、`SHGetKnownFolderPath`和`CoTaskMemFree`函数的实现细节，并提供了完整的Go语言示例代码，帮助开发者正确地进行Windows特殊文件夹路径的查询和内存管理。

简介与核心概念

在Windows系统中，获取特殊文件夹（如字体目录、程序文件目录等）的推荐方式是调用Shell API中的SHGetKnownFolderPath函数。这个函数能够根据一个已知的文件夹ID（KNOWNFOLDERID）返回对应的文件系统路径。由于Go语言的标准库没有直接提供此功能，我们需要借助syscall包来调用底层的Windows API。

SHGetKnownFolderPath函数的C++签名如下：

HRESULT SHGetKnownFolderPath(
  _In_      REFKNOWNFOLDERID rfid,
  _In_      DWORD dwFlags,
  _In_opt_  HANDLE hToken,
  _Out_     PWSTR *ppszPath
);

登录后复制

其中，REFKNOWNFOLDERID是一个GUID结构体，用于标识特定的已知文件夹。ppszPath参数在函数成功返回后会指向一个由CoTaskMemAlloc分配的字符串缓冲区，因此在不再使用该路径时，必须调用CoTaskMemFree函数来释放这块内存，以避免内存泄漏。

立即学习“go语言免费学习笔记（深入）”；

Go语言实现细节

为了在Go语言中调用上述API，我们需要进行以下步骤：

1. 定义GUID结构体与FOLDERID_Fonts

KNOWNFOLDERID实际上是一个GUID（全局唯一标识符）。我们需要在Go中定义一个对应的结构体，并提供字体目录的GUID常量。

package main

import (
    "fmt"
    "syscall"
    "unsafe"
)

// GUID 结构体定义，对应Windows API中的GUID
type GUID struct {
    Data1 uint32
    Data2 uint16
    Data3 uint16
    Data4 [8]byte
}

// FOLDERID_Fonts 是字体目录的KNOWNFOLDERID
var FOLDERID_Fonts = GUID{0xFD228CB7, 0xAE11, 0x4AE3, [8]byte{0x86, 0x4C, 0x16, 0xF3, 0x91, 0x0A, 0xB8, 0xFE}}

登录后复制

2. 加载DLL并获取函数指针

使用syscall.NewLazyDLL和NewProc来加载Shell32.dll和Ole32.dll，并获取SHGetKnownFolderPath和CoTaskMemFree的函数指针。

Starry.ai

AI艺术绘画生成器

查看详情

var (
    modShell32               = syscall.NewLazyDLL("Shell32.dll")
    modOle32                 = syscall.NewLazyDLL("Ole32.dll")
    procSHGetKnownFolderPath = modShell32.NewProc("SHGetKnownFolderPath")
    procCoTaskMemFree        = modOle32.NewProc("CoTaskMemFree")
)

登录后复制

3. 封装SHGetKnownFolderPath函数

在Go中封装SHGetKnownFolderPath，需要将Go类型映射到C类型，并使用syscall.Syscall6进行实际的API调用。unsafe.Pointer在这里是必需的，因为它允许我们将Go的指针类型转换为uintptr，以传递给C函数。

// SHGetKnownFolderPath 封装了Windows API SHGetKnownFolderPath
func SHGetKnownFolderPath(rfid *GUID, dwFlags uint32, hToken syscall.Handle, pszPath *uintptr) (retval error) {
    // Syscall6用于调用带有6个参数的Windows API
    // r0 是HRESULT返回值
    r0, _, _ := syscall.Syscall6(procSHGetKnownFolderPath.Addr(), 4, // 4表示参数数量
        uintptr(unsafe.Pointer(rfid)),       // rfid (REFKNOWNFOLDERID)
        uintptr(dwFlags),                    // dwFlags
        uintptr(hToken),                     // hToken (通常为0)
        uintptr(unsafe.Pointer(pszPath)),    // ppszPath (PWSTR *)
        0, 0)                                // 额外的参数，此处不使用
    if r0 != 0 {
        retval = syscall.Errno(r0)           // 如果返回非0，表示错误
    }
    return
}

登录后复制

4. 封装CoTaskMemFree函数

同样，封装CoTaskMemFree用于释放由SHGetKnownFolderPath分配的内存。

// CoTaskMemFree 封装了Windows API CoTaskMemFree
func CoTaskMemFree(pv uintptr) {
    // Syscall用于调用带有1个参数的Windows API
    syscall.Syscall(procCoTaskMemFree.Addr(), 1, uintptr(pv), 0, 0)
    return
}

登录后复制

5. 创建FontFolder辅助函数

为了更方便地获取字体目录，可以创建一个FontFolder函数来整合上述逻辑，并处理路径转换和内存释放。

// FontFolder 获取Windows字体目录的路径
func FontFolder() (string, error) {
    var path uintptr // 用于接收路径的指针
    // 调用SHGetKnownFolderPath获取字体目录路径
    err := SHGetKnownFolderPath(&FOLDERID_Fonts, 0, 0, &path)
    if err != nil {
        return "", err
    }
    // 确保在函数退出时释放内存
    defer CoTaskMemFree(path)
    // 将UTF-16编码的路径转换为Go的string类型
    folder := syscall.UTF16ToString((*[1 << 16]uint16)(unsafe.Pointer(path))[:])
    return folder, nil
}

登录后复制

这里使用了defer CoTaskMemFree(path)来确保即使在UTF16ToString转换失败或后续操作出错时，内存也能被正确释放，这是良好的实践。

完整示例代码

将以上所有部分组合起来，构成一个完整的Go程序：

package main

import (
    "fmt"
    "syscall"
    "unsafe"
)

// GUID 结构体定义，对应Windows API中的GUID
type GUID struct {
    Data1 uint32
    Data2 uint16
    Data3 uint16
    Data4 [8]byte
}

// FOLDERID_Fonts 是字体目录的KNOWNFOLDERID
var FOLDERID_Fonts = GUID{0xFD228CB7, 0xAE11, 0x4AE3, [8]byte{0x86, 0x4C, 0x16, 0xF3, 0x91, 0x0A, 0xB8, 0xFE}}

var (
    modShell32               = syscall.NewLazyDLL("Shell32.dll")
    modOle32                 = syscall.NewLazyDLL("Ole32.dll")
    procSHGetKnownFolderPath = modShell32.NewProc("SHGetKnownFolderPath")
    procCoTaskMemFree        = modOle32.NewProc("CoTaskMemFree")
)

// SHGetKnownFolderPath 封装了Windows API SHGetKnownFolderPath
func SHGetKnownFolderPath(rfid *GUID, dwFlags uint32, hToken syscall.Handle, pszPath *uintptr) (retval error) {
    r0, _, _ := syscall.Syscall6(procSHGetKnownFolderPath.Addr(), 4,
        uintptr(unsafe.Pointer(rfid)),
        uintptr(dwFlags),
        uintptr(hToken),
        uintptr(unsafe.Pointer(pszPath)),
        0, 0)
    if r0 != 0 {
        retval = syscall.Errno(r0)
    }
    return
}

// CoTaskMemFree 封装了Windows API CoTaskMemFree
func CoTaskMemFree(pv uintptr) {
    syscall.Syscall(procCoTaskMemFree.Addr(), 1, uintptr(pv), 0, 0)
    return
}

// FontFolder 获取Windows字体目录的路径
func FontFolder() (string, error) {
    var path uintptr
    err := SHGetKnownFolderPath(&FOLDERID_Fonts, 0, 0, &path)
    if err != nil {
        return "", err
    }
    defer CoTaskMemFree(path)
    folder := syscall.UTF16ToString((*[1 << 16]uint16)(unsafe.Pointer(path))[:])
    return folder, nil
}

func main() {
    folder, err := FontFolder()
    if err != nil {
        fmt.Println("获取字体目录失败:", err)
        return
    }
    fmt.Println("字体目录:", folder)
}

登录后复制

运行上述代码，在Windows系统上通常会得到类似以下输出：

字体目录: C:\Windows\Fonts

登录后复制

注意事项与总结

unsafe包的使用: 调用Windows API通常需要使用unsafe.Pointer进行类型转换，这绕过了Go的类型安全检查。在使用时务必小心，确保类型转换的正确性，避免内存损坏。
内存管理: SHGetKnownFolderPath返回的路径字符串是由CoTaskMemAlloc分配的，因此必须使用CoTaskMemFree来释放。使用defer关键字可以确保在函数退出时无论发生什么情况，内存都能被正确释放。
错误处理: 始终检查SHGetKnownFolderPath的返回值，syscall.Errno(r0)可以将API返回的错误码转换为Go的error类型。
平台限制: 此方法仅适用于Windows操作系统。在跨平台应用中，需要针对不同操作系统提供不同的实现。
扩展性: 掌握了这种调用Windows API的方法，您可以举一反三，通过查找其他KNOWNFOLDERID的值来获取其他系统特殊文件夹的路径。