Share via


SpCreatePhoneConverter (Windows Embedded CE 6.0)

1/6/2010

This function creates an object implementing ISpPhoneConverter that allows conversion from the SAPI character phone set to the identifier phone set. This function calls the helper function SpCreateBestObject with the category identifier SPCAT_PHONECONVERTERS.

Syntax

inline HRESULT SpCreatePhoneConverter(
  LANGID* langid,
  const WCHAR* pszReqAttribs,
  const WCHAR* pszOptAttribs,
  ISpPhoneConverter** ppPhoneConverter
);

Parameters

  • langid
    [in] Pointer to the language identifier of the word. This value cannot be NULL or zero.
  • pszReqAttribs
    [in] Pointer to required attributes for the token.
  • pszOptAttribs
    [in] Pointer to optional attributes for the token.
  • ppPhoneConverter
    [out] Address of a pointer to an object implementing ISpPhoneConverter.

Return Value

The following table shows the possible return values.

Value Description

S_OK

Function completed successfully.

E_INVALIDARG

langid equals zero.

FAILED(hr)

Appropriate error message.

Requirements

Header sphelper.h
Library sapilib.lib
Windows Embedded CE Windows CE .NET 4.1 and later

See Also

Reference

SAPI Functions