IInkCustomStrokes::Item

4/8/2010

Returns the IInkStrokes object at the specified index within the IInkCustomStrokes collection.

Syntax

HRESULT Item (
  [in] VARIANT identifier,
  [out, retval] IInkExtendedProperty **Item
);

Parameters

  • Item
    Returns the IInkCustomStrokes object at the specified index within the IInkCustomStrokes collection.

Return Value

HRESULT value Description

S_OK

Success.

E_POINTER

A parameter contained an invalid pointer.

E_FAIL

An unspecified error occurred.

CO_E_CLASSTRING

Invalid GUID format.

DISP_E_TYPEMISMATCH

One of the parameters is not a valid VARIANT type.

E_INVALIDARG

Invalid argument.

E_UNEXPECTED

Unexpected parameter or property type.

REGDB_CLASSNOTREG

Type object not registered.

E_OUTOFMEMORY

Cannot allocate memory to complete the operation.

E_INK_EXCEPTION

An exception occurred inside the method.

TPC_E_RECOGNIZER_NOT_REGISTERED

The recognizer's registry key is corrupted.

Remarks

An error occurs if the index doesn't match any existing member of the collection.

The Item method takes an input argument of type VARIANT. However, the subtype of this variable must be integer or STRING (BSTR). This means that when you are using late binding, such as when you dimension a variable as type OBJECT in Visual Basic 6.0 or when you use a scripting language, you must either dimension the argument variable as a STRING (Visual Basic 6.0) or pass in the argument as a STRING literal and not use a variable (script).

For more information about the VARIANT and BSTR data types, see Using the Automation Library with Windows Mobile Ink.

Requirements

Header msinkaut.h
Windows Embedded CE Windows CE 5.0 and later
Windows Mobile Windows Mobile 6 Classic and later, Windows Mobile 6 Professional and later

See Also

Concepts

Windows Mobile Ink Reference