SpCreatePhoneConverter
Other versions of this page are also available for the following:
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
8/28/2008
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 |