本文详细介绍了如何使用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类型的指针，指向一个用于接收路径指针的变量。
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 
