ScriptApplyDigitSubstitution function (usp10.h)

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

See also

Digit Shapes

Displaying Text with Uniscribe

SCRIPT_CONTROL

SCRIPT_DIGITSUBSTITUTE

SCRIPT_STATE

ScriptRecordDigitSubstitution

Uniscribe

Uniscribe Functions