ScriptStringGetOrder (Windows Embedded CE 6.0)

1/6/2010

This function creates an array that maps an original character position to a glyph position.

Syntax

HRESULT WINAPI ScriptStringGetOrder(
  SCRIPT_STRING_ANALYSIS ssa, 
  UINT *puOrder 
);

Parameters

• ssa
  [in] A SCRIPT_STRING_ANALYSIS structure for the string.

• puOrder
  [out] Pointer to the array that receives the glyph positions, indexed by the original character position. The array should have room for at least *ScriptString_pcOutChars(ssa) ints.

Return Value

If the function is successful, it returns S_OK.

If the function fails, it returns an HRESULT.

The return value can be tested with the SUCCEEDED and FAILED macros.

Remarks

When there are an equal number of glyphs and characters, the function returns an array that references every glyph. This function requires that SSA_GLYPHS was requested in the original call to ScriptStringAnalyse

Requirements

See Also

Reference

ScriptStringAnalyse
SCRIPT_STRING_ANALYSIS

Other Resources

Uniscribe Functions