CloseTouchInputHandle function (Windows)

Applies to: desktop apps only

Closes a touch input handle, frees process memory associated with it, and invalidates the handle.

Syntax

BOOL WINAPI CloseTouchInputHandle(
  __in  HTOUCHINPUT hTouchInput
);

Parameters

hTouchInput [in]

The touch input handle received in the LPARAM of a touch message. The function fails with ERROR_INVALID_HANDLE if this handle is not valid. Note that the handle is not valid after it has been used in a successful call to CloseTouchInputHandle or after it has been passed to DefWindowProc, PostMessage, SendMessage or one of their variants.

Return value

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero. To get extended error information, use the GetLastError function.

Remarks

Calling CloseTouchInputHandle will not free memory associated with values retrieved in a call to GetTouchInputInfo. Values in structures passed to GetTouchInputInfo will be valid until you delete them.

Requirements

See also

Functions

GetTouchInputInfo

Send comments about this topic to Microsoft

Build date: 3/7/2012