Windows DLLs[Go语言使用DLL动态链接库]

原文：https://github.com/golang/go/wiki/WindowsDLLs
作者：Gopal Adhikari edited this page on 29 Apr 2018
翻译：GeMarK

---

调用一个Windows DLL

Go语言允许您以几种不同的方式调用Windows本机系统功能。

1. 动态加载DLL，然后调用其中的函数。你可以通过调用 SyscallX 函数（其中 X 是参数的数量，如果函数的参数少于此指，例如将7个参数传递给接收9个参数的函数，Syscall9 仍然可以工作，你只需指定 7 作为你的 Syscall9 的第二个参数）。

使用此方法调用Windows DLL函数的Go程序示例：

package main

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

// 定义错误退出
func abort(funcname string, err error) {
	panic(fmt.Sprintf("%s failed: %v", funcname, err))
}

// 定义 kernal32.dll 的动态链接库载入与获取kernel32库中的GetModuleHandleW方法（函数）
// 定义 user32.dll 的动态链接库.....获取库中的MessageBoxW方法
// W是wchar宽字符（windows的字符集，非utf8）
var (
	kernel32, _        = syscall.LoadLibrary("kernel32.dll")
	getModuleHandle, _ = syscall.GetProcAddress(kernel32, "GetModuleHandleW")

	user32, _     = syscall.LoadLibrary("user32.dll")
	messageBox, _ = syscall.GetProcAddress(user32, "MessageBoxW")
)

// MessageBox的常量（按钮，如：MB_OK就只有一个OK按钮，而MB_OKCANCEL则有OK与CANCEL按钮）
// 对应OK就是“确定”，OKCANCEL就是“确定”与“取消”按钮 etc.
const (
	MB_OK                = 0x00000000
	MB_OKCANCEL          = 0x00000001
	MB_ABORTRETRYIGNORE  = 0x00000002
	MB_YESNOCANCEL       = 0x00000003
	MB_YESNO             = 0x00000004
	MB_RETRYCANCEL       = 0x00000005
	MB_CANCELTRYCONTINUE = 0x00000006
	MB_ICONHAND          = 0x00000010
	MB_ICONQUESTION      = 0x00000020
	MB_ICONEXCLAMATION   = 0x00000030
	MB_ICONASTERISK      = 0x00000040
	MB_USERICON          = 0x00000080
	MB_ICONWARNING       = MB_ICONEXCLAMATION
	MB_ICONERROR         = MB_ICONHAND
	MB_ICONINFORMATION   = MB_ICONASTERISK
	MB_ICONSTOP          = MB_ICONHAND

	MB_DEFBUTTON1 = 0x00000000
	MB_DEFBUTTON2 = 0x00000100
	MB_DEFBUTTON3 = 0x00000200
	MB_DEFBUTTON4 = 0x00000300
)

// 将Win系统的C style函数进行包装（wrap）,包装成go的函数MessageBox
// caption, text 为string类型参数
// style 为一个uintptr参数（存储指针值的类型，但不是指针类型，可以与unsafe.Pointer进行互相转换）
// 返回类型 result为一个int类型，详情见下面链接
// https://docs.microsoft.com/en-us/openspecs/windows_protocols/ms-erref/1bc92ddf-b79e-413c-bbaa-99a5281a6c90
func MessageBox(caption, text string, style uintptr) (result int) {
	var nargs uintptr = 4
	ret, _, callErr := syscall.Syscall9(uintptr(messageBox),
		nargs,
		0,
		uintptr(unsafe.Pointer(syscall.StringToUTF16Ptr(text))),
		uintptr(unsafe.Pointer(syscall.StringToUTF16Ptr(caption))),
		style,
		0,
		0,
		0,
		0,
		0)
	if callErr != 0 {
		abort("Call MessageBox", callErr)
	}
	result = int(ret)
	return
}

// 包装DLL中的的 getModuleHandle
// GetModuleHandle 获取模组句柄
// 返回类型是一个uintptr
func GetModuleHandle() (handle uintptr) {
	var nargs uintptr = 0
	if ret, _, callErr := syscall.Syscall(uintptr(getModuleHandle), nargs, 0, 0, 0); callErr != 0 {
		abort("Call GetModuleHandle", callErr)
	} else {
		handle = ret
	}
	return
}

func main() {
	// 栈底延迟 释放动态链接库
	defer syscall.FreeLibrary(kernel32)
	defer syscall.FreeLibrary(user32)
	
	// 弹出窗口，使用包装后的MessageBoxW
	fmt.Printf("Return: %d\n", MessageBox("Done Title", "This test is Done.", MB_YESNOCANCEL))
}

func init() {
	fmt.Print("Starting Up\n")
}

2. 使用 syscall.NewProc 而不是 syscall.GetProcAddress 。这些基本上是一些辅助方法，而不是上面提到的系统调用方法，并且仅在Windows中可用：
   http://golang.org/src/pkg/syscall/dll_windows.go
   https://godoc.org/golang.org/x/sys/windows
   上面提到的 HRESULT 的错误代码，在https://godoc.org/golang.org/x/sys/windows中有定义

package main

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

func main() {
	var mod = syscall.NewLazyDLL("user32.dll")
	var proc = mod.NewProc("MessageBoxW")
	var MB_YESNOCANCEL = 0x00000003

	ret, _, _ := proc.Call(0,
		uintptr(unsafe.Pointer(syscall.StringToUTF16Ptr("This test is Done."))),
		uintptr(unsafe.Pointer(syscall.StringToUTF16Ptr("Done Title"))),
		uintptr(MB_YESNOCANCEL))
	fmt.Printf("Return: %d\n", ret)
}

3. 通过“链接”库，使用“cgo”方法（这种方式适用于Linux和Windows） 例：

import ("C")
...
C.MessageBoxW(...)

See cgo for further details.