IInkStrokeDisp::ID property

Gets the identifier of an object.

This property is read-only.

Syntax


HRESULT get_ID(
  [out, retval] long *ID
);

Property value

An identifier for the object.

Error codes

NameMeaning
S_OK

Success.

E_INKEXCEPTION

An exception occurred while processing.

E_POINTER

The parameter is an invalid pointer.

E_FAIL

An unspecified error occurred.

E_UNEXPECTED

Unexpected parameter or property type.

Remarks

An object's identifier never changes.

Note  Accessing this property within certain message handlers can result in the underlying function being re-entered, 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.
 

Requirements

Minimum supported client

Windows XP Tablet PC Edition [desktop apps only]

Minimum supported server

None supported

Header

Msinkaut.h (also requires Msinkaut_i.c)

Library

InkObj.dll

See also

IInkStrokeDisp Interface

 

 

Show: