C# P/Invoke 參數類型對照表 (一) - Wtypes.h 核心類型速查

編輯：關於C語言

撰寫 C# DllImport 互操作時，Win32 API 的龐雜類型 (HANDLE、LPSTR、DWORD、WPARAM...) 讓人頭痛。本文整理 `Wtypes.h` 定義的核心非托管類型與 .NET 托管類型的標準對照，作為速查表。

核心類型對照表 (Wtypes.h 節錄)

非托管類型 (Wtypes.h)	C 語言類型	.NET 托管類型	大小 / 備註
HANDLE	void*	IntPtr / nint	32/64 位元自適應，所有句柄通用
BYTE	unsigned char	byte	8 位元
SHORT	short	short	16 位元
WORD / USHORT	unsigned short	ushort	16 位元
INT / LONG	int / long	int	32 位元 (Win32 long 為 32 位)
UINT / ULONG / DWORD	unsigned int / long	uint	32 位元
BOOL	long	int / bool	32 位元，非零為真；建議用 int 並自行轉換
FLOAT	float	float	32 位元 IEEE 754
DOUBLE	double	double	64 位元 IEEE 754
CHAR	char	sbyte / byte	ANSI 字元，8 位元
WCHAR / OLECHAR	wchar_t	char	Unicode 字元，16 位元
LPSTR / LPCSTR	char* / const char*	string / StringBuilder	[MarshalAs(UnmanagedType.LPStr)]
LPWSTR / LPCWSTR	wchar_t* / const wchar_t*	string / StringBuilder	[MarshalAs(UnmanagedType.LPWStr)] 預設
BSTR	wchar_t* (長度前綴)	string	[MarshalAs(UnmanagedType.BStr)] COM 專用

32 位元基準：本表假設 32 位元進程；64 位元下 `IntPtr`、`HANDLE`、`WPARAM`、`LPARAM`、`LRESULT` 為 64 位，其餘基本型別不變。
句柄統一用 IntPtr：`HWND`、`HDC`、`HKEY`、`HMODULE`... 所有 `H*` 類型一律對應 `IntPtr`，迄今未遇反例。
指標類型策略：
- 字串指標 (`LP*STR`, `LPC*STR`, `P*STR`) → `string` / `StringBuilder`。
- 資料指標 (`LP*DWORD`, `PINT` 等) → 陣列型別 (`uint[]`, `int[]`) 方便 .NET 存取；或 `IntPtr` 配合 `Marshal.Copy`。
- 不透明指標 (`LPVOID`, `PVOID`) → `IntPtr`。
CharSet 設定：`[DllImport("dll", CharSet = CharSet.Auto)]` 讓執行期依平台自動選 ANSI/Unicode 版本 (如 `MessageBox` → `MessageBoxA`/`MessageBoxW`)。

現象	可能原因	修正
呼叫後參數值亂碼/錯誤	CharSet 不匹配導致 ANSI/Unicode 字串解碼錯誤	明確指定 CharSet.Ansi 或 Unicode
AccessViolationException	結構體大小/對齊錯誤、陣列長度不足、傳遞 null 給非可空指標	檢查 StructLayout.Pack、確保陣列預分配、使用 SafeHandle
64 位元下 Crash	句柄/指標用 int 而非 IntPtr	全部改為 IntPtr / nint
回呼不被觸發	委派被 GC 回收	靜態欄位或 GCHandle.Alloc 持有委派