在windows操作系统中，获取特定系统文件夹的路径（如字体目录、程序文件目录等）是一项常见的编程需求。虽然有些路径可以通过环境变量获取，但更健壮和官方推荐的方式是使用windows api shgetknownfolderpath。本文将指导您如何利用go语言的syscall包，安全且准确地调用此api来获取windows系统的字体目录。
理解 SHGetKnownFolderPath API
SHGetKnownFolderPath 是 Shell32.dll 中的一个函数，用于检索已知文件夹的完整路径。其C/C++签名如下：
HRESULT SHGetKnownFolderPath( _In_ REFKNOWNFOLDERID rfid, _In_ DWORD dwFlags, _In_opt_ HANDLE hToken, _Out_ PWSTR *ppszPath);
该函数的主要参数及其作用如下：
rfid: 指向一个 KNOWNFOLDERID 的引用，这是一个表示已知文件夹的GUID（全局唯一标识符）。对于字体目录，我们使用 FOLDERID_Fonts。dwFlags: 控制检索行为的标志，通常设为 0。hToken: 用于指定用户上下文的访问令牌，通常设为 NULL (或 0)，表示当前用户。ppszPath: 输出参数，指向一个 PWSTR (宽字符字符串) 的指针，该指针将接收文件夹的路径。需要特别注意的是，此内存由 SHGetKnownFolderPath 在COM任务内存分配器中分配，因此必须由调用者使用 CoTaskMemFree 函数（位于 Ole32.dll）进行释放，以避免内存泄漏。
Go语言实现细节
为了在Go中调用这个C风格的Windows API，我们需要使用 syscall 包进行底层交互。
1. GUID 结构体定义
Windows API中 KNOWNFOLDERID 是一个 GUID 类型。我们需要在Go中定义一个对应的结构体，并为 FOLDERID_Fonts 提供其特定的GUID值：
立即学习“go语言免费学习笔记（深入）”；
// GUID 结构体定义，对应 Windows API 中的 GUIDtype 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. 加载DLL和函数
使用 syscall.NewLazyDLL 和 NewProc 来加载所需的动态链接库 (Shell32.dll 和 Ole32.dll)，并获取 SHGetKnownFolderPath 和 CoTaskMemFree 的函数指针：
var ( modShell32 = syscall.NewLazyDLL("Shell32.dll") modOle32 = syscall.NewLazyDLL("Ole32.dll") procSHGetKnownFolderPath = modShell32.NewProc("SHGetKnownFolderPath") procCoTaskMemFree = modOle32.NewProc("CoTaskMemFree"))
3. SHGetKnownFolderPath Go语言封装
我们将 SHGetKnownFolderPath 封装成一个Go函数，以便更安全、便捷地调用。这里需要使用 syscall.Syscall6 来调用C函数，并处理参数类型转换：
func SHGetKnownFolderPath(rfid *GUID, dwFlags uint32, hToken syscall.Handle, pszPath *uintptr) (retval error) { // syscall.Syscall6 用于调用带有6个参数的Windows API函数 // 参数依次为：函数地址, 参数数量, 参数1, 参数2, ..., 参数6 r0, _, _ := syscall.Syscall6(procSHGetKnownFolderPath.Addr(), 4, uintptr(unsafe.Pointer(rfid)), // rfid (指向 GUID 的指针) uintptr(dwFlags), // dwFlags uintptr(hToken), // hToken uintptr(unsafe.Pointer(pszPath)), // ppszPath (指向 uintptr 的指针，用于接收路径指针) 0, 0) // 额外的参数，未用 if r0 != 0 { // HRESULT 为非0表示错误 retval = syscall.Errno(r0) } return}
unsafe.Pointer 用于将Go的指针类型转换为 uintptr，以便传递给 Syscall6，这是Go与C/C++底层交互时常用的手段。
4. CoTaskMemFree Go语言封装
同样，封装 CoTaskMemFree 函数，用于释放 SHGetKnownFolderPath 分配的内存：
func CoTaskMemFree(pv uintptr) { // syscall.Syscall 用于调用带有3个参数的Windows API函数 syscall.Syscall(procCoTaskMemFree.Addr(), 1, uintptr(pv), 0, 0) return}
5. 获取字体目录的 FontFolder 函数
这个函数将协调上述所有步骤，提供一个简洁的接口来获取字体目录：
func FontFolder() (string, error) { var path uintptr // 用于接收 SHGetKnownFolderPath 返回的路径指针 err := SHGetKnownFolderPath(&FOLDERID_Fonts, 0, 0, &path) if err != nil { return "", err } defer CoTaskMemFree(path) // 确保在函数返回前释放内存 // 将 UTF16 编码的路径转换为 Go 的 string // (*[1 << 16]uint16)(unsafe.Pointer(path))[:] 创建一个指向路径内存的切片， // 1 << 16 (即 65536) 是一个足够大的值，确保能覆盖常见路径的最大长度 folder := syscall.UTF16ToString((*[1 << 16]uint16)(unsafe.Pointer(path))[:]) return folder, nil}
这里 defer CoTaskMemFree(path) 的使用至关重要，它保证了即使在函数中途发生错误，由Windows API分配的内存也能被正确释放。syscall.UTF16ToString 用于将Windows API返回的UTF-16编码字符串转换为Go的UTF-8字符串。
完整代码示例
将上述所有部分组合起来，构成一个完整的Go程序：
package mainimport ( "fmt" "syscall" "unsafe" // 导入 unsafe 包以进行指针操作)// GUID 结构体定义，对应 Windows API 中的 GUIDtype GUID struct { Data1 uint32 Data2 uint16 Data3 uint16 Data4 [8]byte}// FOLDERID_Fonts 的 GUID 常量，表示 Windows 字体文件夹var ( FOLDERID_Fonts = GUID{0xFD228CB7, 0xAE11, 0x4AE3, [8]byte{0x86, 0x4C, 0x16, 0xF3, 0x91, 0x0A, 0xB8, 0xFE}})// 加载 Shell32.dll 和 Ole32.dll，并获取 SHGetKnownFolderPath 和 CoTaskMemFree 的函数指针var ( modShell32 = syscall.NewLazyDLL("Shell32.dll") modOle32 = syscall.NewLazyDLL("Ole32.dll") procSHGetKnownFolderPath = modShell32.NewProc("SHGetKnownFolderPath") procCoTaskMemFree = modOle32.NewProc("CoTaskMemFree"))// SHGetKnownFolderPath 的 Go 语言封装// rfid: 已知文件夹的 GUID// dwFlags: 标志，通常为 0// hToken: 用户访问令牌，通常为 0 (NULL)// pszPath: 输出参数，接收路径字符串的指针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 { // 如果返回的 HRESULT 非 0，表示有错误 retval = syscall.Errno(r0) } return}// CoTaskMemFree 的 Go 语言封装// pv: 指向由 COM 任务内存分配器分配的内存块的指针func CoTaskMemFree(pv uintptr) { syscall.Syscall(procCoTaskMemFree.Addr(), 1, uintptr(pv), 0, 0) return}// FontFolder 函数：获取 Windows 字体目录路径// 返回字体目录路径字符串或错误func FontFolder() (string, error) { var path uintptr // 用于接收 SHGetKnownFolderPath 返回的路径指针 // 调用 SHGetKnownFolderPath 获取字体目录路径 err := SHGetKnownFolderPath(&FOLDERID_Fonts, 0, 0, &path) if err != nil { return "", err
以上就是Go语言调用Windows API获取Windows字体目录的详细内容，更多请关注创想鸟其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1415689.html
微信扫一扫 
支付宝扫一扫 
