Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
4/8/2010

Returns the value of a specified property of the IInkRecognitionAlternate.

Syntax

HRESULT GetPropertyValue (
  [in] BSTR propertyType,
  [out, retval] VARIANT *PropertyValue
);

Parameters

propertyType

Specifies which property of the alternate to return, as one of the GUIDs from the RecognitionPropertyobject (see below).

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

PropertyValue

Returns the value of the property type as an array of bytes. The return value is interpreted differently for each property type.

RecognitionProperty Type Description

ConfidenceLevel

CONFIDENCE_LEVEL enumeration type. For more information, see InkRecognitionConfidence.

HotPoint

POINT.

LineMetrics

LATTICE_METRICS structure.

LineNumber

ULONG.

MaximumStrokeCount

Not used.

PointsPerInch

Not used.

Segmentation

Not a value, returns TPC_E_INVALID_PROPERTY.

Return Value

HRESULT value Description

E_INK_EXCEPTION

An exception occurred while processing.

E_POINTER

A parameter contained an invalid pointer.

CO_E_CLASSSTRING

Invalid GUID format.

E_FAIL

An unspecified error occurred.

E_INVALIDARG

The flag is invalid.

E_OUTOFMEMORY

Cannot allocate memory to complete the operation.

S_OK

Success.

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