ScriptString_pLogAttr function (usp10.h)

Returns a pointer to a logical attributes buffer for an analyzed string.

Syntax

const SCRIPT_LOGATTR * ScriptString_pLogAttr(
  [in] SCRIPT_STRING_ANALYSIS ssa
);

Parameters

[in] ssa

A SCRIPT_STRING_ANALYSIS structure for the string.

Return value

Returns a pointer to a buffer containing SCRIPT_LOGATTR structures defining logical attributes if successful. The function returns NULL if it does not succeed.

Remarks

The pointer returned by this function is valid only until the application passes the associated SCRIPT_STRING_ANALYSIS structure to ScriptStringFree.

The logical attribute buffer contains at least the number of integers indicated by the ssa parameter of ScriptString_pcOutChars.

When scanning the SCRIPT_LOGATTR array for a word break point, the application should look backward for the values of the fWordStop and fWhiteSpace members. ScriptStringAnalyse just calls ScriptBreak on each run, and ScriptBreak never sets fWordBreak on the first character of a run, because it has no information that the previous run ended in white space.

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_STRING_ANALYSIS

ScriptBreak

ScriptStringAnalyse

ScriptStringFree

ScriptString_pcOutChars

Uniscribe

Uniscribe Functions