Export (0) Print
Expand All

IInkCursor::Name property

Applies to: desktop apps only

Gets the name of the object.

This property is read-only.

Syntax

HRESULT get_Name(
  [out, retval]  BSTR *Name
);

Property value

The human-readable name of the object.

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

Error codes

NameMeaning
S_OK

Success.

E_FAIL

An unspecified error occurred.

E_INK_EXCEPTION

An exception occurred while processing.

E_OUTOFMEMORY

Cannot allocate memory to complete the operation.

E_POINTER

The parameter is an invalid pointer.

Remarks

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

Minimum supported server

None supported

Header

Msinkaut.h (also requires Msinkaut_i.c)

Library

InkObj.dll

See also

InkCursor Interface

 

 

Send comments about this topic to Microsoft

Build date: 3/6/2012

Community Additions

ADD
Show:
© 2015 Microsoft