ScriptStringValidate (Compact 2013)

3/28/2014

This function checks the SCRIPT_STRING_ANALYSIS structure for invalid sequences.

Syntax

HRESULT WINAPI ScriptStringValidate(
  SCRIPT_STRING_ANALYSIS ssa 
);

Parameters

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

Return Value

If there are no invalid sequences, the function returns S_OK.

If there are one or more invalid sequences, the function returns S_FALSE. If any other unrecoverable error is encountered, it is returned as an HRESULT.

Remarks

This function is intended for use in editors that reject the input of invalid sequences.

Invalid sequences are only checked for those scripts with the fRejectInvalid member set in SCRIPT_PROPERTIES. For example, it is conventional for Notepad to reject invalid Thai character sequences. However, invalid Indian sequences are not conventionally rejected, but instead are displayed in composition with a missing base character symbol.

Requirements

Header

usp10.h

Library

Uspce.lib

See Also

Reference

Uniscribe Functions
SCRIPT_PROPERTIES
SCRIPT_STRING_ANALYSIS