ScriptApplyDigitSubstitution function (usp10.h)

Article
02/22/2024

Applies the specified digit substitution settings to the specified script control and script state structures.

Syntax

HRESULT ScriptApplyDigitSubstitution(
  [in]  const SCRIPT_DIGITSUBSTITUTE *psds,
  [out] SCRIPT_CONTROL               *psc,
  [out] SCRIPT_STATE                 *pss
);

Parameters

[in] psds

Pointer to a SCRIPT_DIGITSUBSTITUTE structure. The application sets this parameter to NULL if the function is to call ScriptRecordDigitSubstitution with LOCALE_USER_DEFAULT.

[out] psc

Pointer to a SCRIPT_CONTROL structure with the fContextDigits and uDefaultLanguage members updated.

[out] pss

Pointer to a SCRIPT_STATE structure with the fDigitSubstitute member updated.

Return value

Returns S_OK if successful. The function returns a nonzero HRESULT value if it does not succeed.

The function returns E_INVALIDARG if it does not recognize the DigitSubstitute member of SCRIPT_DIGITSUBSTITUTE.

Remarks

This function does not actually substitute digits. It just fills in the structures that describe the digit substitution policy. See Displaying Text with Uniscribe for a discussion of the context in which this function is normally called.

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