Edit

Share via

ScriptStringValidate function (usp10.h)

  • Article

Checks a SCRIPT_STRING_ANALYSIS structure for invalid sequences.

Syntax

HRESULT ScriptStringValidate(
  [in] SCRIPT_STRING_ANALYSIS ssa
);

Parameters

[in] ssa

A SCRIPT_STRING_ANALYSIS structure for a string.

Return value

Returns S_OK if no invalid sequences are found. The function returns S_FALSE if one or more invalid sequences are found. The function returns a nonzero HRESULT value if it does not succeed.

Remarks

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

Invalid sequences are only checked for scripts with the fRejectInvalid member set in the associated SCRIPT_PROPERTIES structure. 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.

Important  Starting with Windows 8: To maintain the ability to run on Windows 7, a module that uses Uniscribe must specify Usp10.lib before gdi32.lib in its library list.
 

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header usp10.h
Library Usp10.lib
DLL Usp10.dll
Redistributable Internet Explorer 5 or later on Windows Me/98/95

See also

SCRIPT_PROPERTIES

SCRIPT_STRING_ANALYSIS

Uniscribe

Uniscribe Functions