ScriptFreeCache

The ScriptFreeCache function frees a SCRIPT_CACHE item.

HRESULT WINAPI ScriptFreeCache(
  SCRIPT_CACHE *psc 
);

Parameters

psc

[in/out] Pointer to a SCRIPT_CACHE item to be freed.

Return Values

If the function succeeds, the return value is zero.

If the function fails, it returns a nonzero value. And if any other unrecoverable error is encountered, it is also returned as HRESULT. For example, error returns from Win32 API functions are converted to HRESULT using the HRESULT_FROM_WIN32 macro and returned to the client in the HRESULT.

Remarks

The client may free a SCRIPT_CACHE at any time. Uniscribe maintains reference counts in its font and shaper caches and frees font data only when all sizes of the font are free, and shaper data only when all fonts it supports are freed.

The client should free the SCRIPT_CACHE for a style when it discards that style.

ScriptFreeCache always sets its parameter to NULL to help avoid misreferencing.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Header: Declared in Usp10.h.
  Library: Use Usp10.lib.

See Also

Uniscribe Overview, Uniscribe Functions, SCRIPT_CACHE