ScriptStringFree function (usp10.h)

Article
02/22/2024

Frees a SCRIPT_STRING_ANALYSIS structure.

Syntax

HRESULT ScriptStringFree(
  [in, out] SCRIPT_STRING_ANALYSIS *pssa
);

Parameters

[in, out] pssa

Pointer to a SCRIPT_STRING_ANALYSIS structure.

Return value

Returns S_OK if successful. The function returns a nonzero HRESULT value if it does not succeed. The application can test the return value with the SUCCEEDED and FAILED macros.

Remarks

When your application is finished with a SCRIPT_STRING_ANALYSIS structure, it should free the associated memory by calling this function. After this function is called, the pointers retrieved from ScriptString_pcOutChars, ScriptString_pLogAttr, and ScriptString_pSize that are associated with the pssa parameter are invalid.

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