getPointerInfo 函式 (winuser.h)
取得與目前訊息相關聯之指定指標的資訊。
注意如果您不需要 GetPointerInfo 公開的其他資訊，請使用 GetPointerType。
語法
BOOL GetPointerInfo(
[in] UINT32 pointerId,
[out] POINTER_INFO *pointerInfo
);
參數
[in] pointerId
指標標識碼。
[out] pointerInfo
接收指標資訊的 POINTER_INFO 結構位址。
傳回值
如果函式成功，則傳回值為非零。
如果此函式失敗，則傳回值為零。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。
備註
GetPointerInfo 會擷取與指標訊息相關聯的單一指標資訊。
使用 GetPointerFrameInfo 擷取與一組指標訊息相關聯的框架資訊。
GetPointerInfo 所傳回的信息與呼叫線程所擷取的最新指標訊息相關聯。 當呼叫線程擷取下一個訊息時，可能無法再使用與上一個訊息相關聯的資訊。
如果應用程式未盡可能快速地處理指標輸入訊息，某些訊息可能會聯合成 WM_POINTERUPDATE 訊息。 使用 GetPointerInfoHistory 從最新的 WM_POINTERUPDATE 訊息擷取訊息歷程記錄。
如果不再提供與訊息相關聯的資訊，此函式會失敗，並將最後一個錯誤設定為 ERROR_NO_DATA。
如果呼叫線程沒有擁有已傳遞指標訊息的視窗，此函式會失敗，並將最後一個錯誤設定為 ERROR_ACCESS_DENIED。 請注意，這可能是輸入最初傳遞至的視窗，或者可能是訊息轉送至的視窗。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 8 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2012 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | winuser.h (包括 Windows.h) |
| 程式庫 | User32.lib |
| Dll | User32.dll |
| API 集合 | ext-ms-win-rtcore-ntuser-wmpointer-l1-1-0 (於 Windows 10 10.0.14393 版) |