Go语言调用Windows API：获取Windows系统字体文件夹路径-Golang-PHP中文网

Go语言调用Windows API：获取Windows系统字体文件夹路径

碧海醫心

发布： 2025-10-20 13:21:01

原创

721人浏览过

Go语言调用Windows API：获取Windows系统字体文件夹路径

本文详细介绍了如何使用go语言调用windows api `shgetknownfolderpath` 来获取系统字体文件夹的准确路径。通过`syscall`包实现对`shell32.dll`和`ole32.dll`的调用，文章涵盖了`guid`结构体的定义、api函数签名的适配、内存管理（`cotaskmemfree`）以及完整的示例代码，旨在提供一个健壮且符合windows开发规范的解决方案。

引言：获取Windows特殊文件夹的挑战

在Windows系统中，获取特殊文件夹（如字体目录、程序文件目录等）的路径是一个常见的需求。直接依赖环境变量如%windir%\Fonts可能不够健壮，因为这些路径可能因系统配置而异。Windows API提供了SHGetKnownFolderPath函数，它能够通过一个唯一的KNOWNFOLDERID来可靠地检索这些路径。然而，在Go语言中调用此类C风格的API需要对syscall包有深入理解，并处理数据类型转换和内存管理。

核心概念与API函数

要成功调用SHGetKnownFolderPath，我们需要理解以下几个关键概念和API函数：

1. KNOWNFOLDERID 与 GUID

SHGetKnownFolderPath函数的第一个参数是REFKNOWNFOLDERID，它实际上是一个指向GUID（Globally Unique Identifier）结构体的指针。每个已知的Windows特殊文件夹都有一个预定义的GUID。对于字体文件夹，其KNOWNFOLDERID为FOLDERID_Fonts。

在Go语言中，我们需要定义一个匹配Windows GUID结构体布局的类型：

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

type GUID struct {
    Data1 uint32
    Data2 uint16
    Data3 uint16
    Data4 [8]byte
}

登录后复制

然后，我们可以将FOLDERID_Fonts定义为一个GUID常量：

var (
    FOLDERID_Fonts = GUID{0xFD228CB7, 0xAE11, 0x4AE3, [8]byte{0x86, 0x4C, 0x16, 0xF3, 0x91, 0x0A, 0xB8, 0xFE}}
)

登录后复制

2. SHGetKnownFolderPath 函数

SHGetKnownFolderPath是Shell32.dll中导出的一个函数，其C语言签名如下：

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

登录后复制

rfid: 指向KNOWNFOLDERID（即GUID）的指针。
dwFlags: 用于指定检索选项的标志。通常设置为0。
hToken: 用于表示特定用户。通常设置为0，表示当前用户。
ppszPath: 一个指向PWSTR（宽字符串指针）的指针，用于接收检索到的路径。此内存由函数内部通过CoTaskMemAlloc分配，因此调用者必须使用CoTaskMemFree来释放它。

在Go中调用时，我们需要使用syscall.Syscall6来适配这个签名。PWSTR *ppszPath需要传递一个uintptr类型的指针，指向一个用于接收路径指针的变量。

Dora

创建令人惊叹的3D动画网站，无需编写一行代码。

547

查看详情

3. CoTaskMemFree 函数

由于SHGetKnownFolderPath会在内部为返回的路径字符串分配内存，并且该内存是通过COM任务内存分配器分配的，因此我们必须使用Ole32.dll中的CoTaskMemFree函数来释放这块内存，以避免内存泄漏。

其C语言签名如下：

void CoTaskMemFree(
  _In_opt_ LPVOID pv
);

登录后复制

pv: 指向要释放内存的指针。

在Go中，这可以通过syscall.Syscall来调用。

Go语言实现步骤

以下是使用Go语言实现获取Windows字体文件夹的详细步骤和代码：

1. 导入必要的包

import (
    "fmt"
    "syscall"
    "unsafe" // 用于类型转换
)

登录后复制

2. 定义 GUID 结构体和 FOLDERID_Fonts 常量

type GUID struct {
    Data1 uint32
    Data2 uint16
    Data3 uint16
    Data4 [8]byte
}

var (
    FOLDERID_Fonts = GUID{0xFD228CB7, 0xAE11, 0x4AE3, [8]byte{0x86, 0x4C, 0x16, 0xF3, 0x91, 0x0A, 0xB8, 0xFE}}
)

登录后复制

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

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

登录后复制

4. 封装 SHGetKnownFolderPath 和 CoTaskMemFree

为了更方便地调用和处理错误，我们可以为这两个Windows API函数创建Go语言的包装函数。

// SHGetKnownFolderPath 的 Go 语言包装函数
// 签名：HRESULT SHGetKnownFolderPath(REFKNOWNFOLDERID rfid, DWORD dwFlags, HANDLE hToken, PWSTR *ppszPath)
func SHGetKnownFolderPath(rfid *GUID, dwFlags uint32, hToken syscall.Handle, pszPath *uintptr) (retval error) {
    // 调用 Syscall6，将 Go 类型转换为 uintptr
    // rfid: 指向 GUID 结构体的指针
    // dwFlags, hToken: 直接传递
    // pszPath: 指向 uintptr 变量的指针，用于接收返回的路径指针
    r0, _, _ := syscall.Syscall6(procSHGetKnownFolderPath.Addr(), 4,
        uintptr(unsafe.Pointer(rfid)), // rfid
        uintptr(dwFlags),              // dwFlags
        uintptr(hToken),               // hToken
        uintptr(unsafe.Pointer(pszPath)), // ppszPath
        0, 0)
    if r0 != 0 { // HRESULT 非零表示错误
        retval = syscall.Errno(r0)
    }
    return
}

// CoTaskMemFree 的 Go 语言包装函数
// 签名：void CoTaskMemFree(LPVOID pv)
func CoTaskMemFree(pv uintptr) {
    // 调用 Syscall，释放内存
    syscall.Syscall(procCoTaskMemFree.Addr(), 1, uintptr(pv), 0, 0)
    return
}

登录后复制

5. 实现 FontFolder 函数

这个函数将整合上述步骤，提供一个简洁的接口来获取字体文件夹路径。

// FontFolder 函数封装了获取字体文件夹路径的逻辑
func FontFolder() (string, error) {
    var path uintptr // 用于接收返回的路径指针
    // 调用 SHGetKnownFolderPath

登录后复制

以上就是Go语言调用Windows API：获取Windows系统字体文件夹路径的详细内容，更多请关注php中文网其它相关文章！

大家都在看：

Go语言实现PDF到Word文档的原理和步骤高效的PDF转Word文档解决方案在Go语言中简易教程：Go语言实现PDF转换为word文档 Go语言中实现将PDF文件转换为Word文档的实用方法使用Go语言进行PDF到Word文档转换的高效解决方案