Win32 API 句柄參數類型選擇：int 與 IntPtr 的區別

直接回答

`SendMessage` 等 Win32 API 有**多個重載簽名**，參數類型根據消息類型（`wParam`/`lParam` 含義）而異：

• 部分消息的 `wParam`/`lParam` 是**整數值**（如 `WM_SETTEXT` 的 `lParam` 是字符串指針，但 `WM_CLOSE` 兩參數均為 0）→ 簽名用 `int`/`uint`。
• 部分消息的參數是**指針/句柄**（如 `WM_GETTEXT` 的 `lParam` 是緩衝區指針，`HWND` 類型）→ 簽名用 `IntPtr`/`HandleRef`。

C# P/Invoke 正確簽名模式

// 通用簽名：使用 IntPtr 兼容所有指針/句柄/整數（推薦）
[DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = true)]
public static extern IntPtr SendMessage(IntPtr hWnd, uint Msg, IntPtr wParam, IntPtr lParam);

// 特定消息重載：針對 wParam/lParam 為整數值的場景
[DllImport("user32.dll", CharSet = CharSet.Auto)]
public static extern IntPtr SendMessage(IntPtr hWnd, uint Msg, int wParam, int lParam);

// 字符串專用重載（lParam 為 StringBuilder）
[DllImport("user32.dll", CharSet = CharSet.Auto)]
public static extern IntPtr SendMessage(IntPtr hWnd, uint Msg, int wParam, StringBuilder lParam);

為什麼不能隨意用 int？

最佳實踐

1. **優先使用 `IntPtr` 通用簽名**，調用時傳入 `IntPtr.Zero`、`(IntPtr)intValue`、`handle.DangerousGetHandle()`、`Marshal.StringToHGlobalAuto(str)` 等。
2. 針對高頻消息（如 `WM_SETTEXT`、`WM_GETTEXTLENGTH`）提供**特化重載**（`int`/`StringBuilder`），提升可讀性與性能（避免裝箱）。
3. 參考 pinvoke.net 獲取標準簽名，勿自行猜測。

總結

「同一句柄參數，有的用 `int` 有的用 `IntPtr`」是因為 **API 重載** 針對不同消息的參數語義優化。**64 位安全**請統一用 `IntPtr`，特定整數值消息可用 `int` 重載。

1. 上一篇文章： jQuery 獲取上一次點擊元素的索引
2. 下一篇文章： C/C++ 運算符優先級陷阱：x += x -= x - x-- 逐步求值

程式設計綜合問答

Android Studio / Eclipse 誤刪配置導致無法創建項目：重置開發環境指南

故障現象 刪除舊項目時誤勾選關鍵配置文件。

Eclipse SE/EE 編譯器合規級別差異導致 StringBuffer 接收 int 數組報錯

問題現象 同樣代碼在 Notepad+javac、Eclip

Win32 對話框編輯框獲取數字輸入的完整實現

核心 API 介紹 在 Win32 應用程序中，從對話框的編

Socket InputStream 讀取長度前綴問題：PushbackInputStream 回退字節實現協議解析

場景 自定義協議：`[10位長度數字][JSON數據]`，如