ScriptStringValidate function (usp10.h)

Article
02/22/2024

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