IInkTablets::IsPacketPropertySupported method (msinkaut.h)

Determines whether a property of a tablet device or a collection of tablet devices, identified with a globally unique identifier (GUID), is supported. For example, use this method to determine if all of the tablets in a collection support tangential pressure from a pen.


HRESULT IsPacketPropertySupported(
  [in]          BSTR         packetPropertyName,
  [out, retval] VARIANT_BOOL *Supported


[in] packetPropertyName

The GUID for the PacketProperty GUIDs of the tablet or tablets that is requested. Use a defined BSTR constant from the PacketProperty constants.

For more information about the BSTR data type, see Using the COM Library.

[out, retval] Supported

When this method returns, contains VARIANT_TRUE if a known property is supported by the tablet or tablets; otherwise, VARIANT_FALSE.

Note  This method can be re-entered when called within certain message handlers, causing unexpected results. Take care to avoid a reentrant call when handling any of the following messages: WM_ACTIVATE, WM_ACTIVATEAPP, WM_NCACTIVATE, WM_PAINT; WM_SYSCOMMAND if wParam is set to SC_HOTKEY or SC_TASKLIST; and WM_SYSKEYDOWN (when processing Alt-Tab or Alt-Esc key combinations). This is an issue with single-threaded apartment model applications.

Return value

This method can return one of these values.

Return code Description
A parameter contained an invalid pointer.
Invalid GUID format.
An exception occurred while processing.
The flag is invalid.


Note  When this method is called on the InkTablets collection, it queries all of the tablets on the system. If any of them does not support the property, it returns VARIANT_FALSE. Call IsPacketPropertySupported on an individual IInkTablet object to determine whether the device supports a known property.


Minimum supported client Windows XP Tablet PC Edition [desktop apps only]
Minimum supported server None supported
Target Platform Windows
Header msinkaut.h
Library InkObj.dll

See also

GetPacketData Method

IInkTablet Class


InkTablets Collection

SetPacketValuesByProperty Method