Share via


ISpPhoneConverter::IdToPhone (Windows Embedded CE 6.0)

1/6/2010

This method converts a zero-terminated identifier code array to the SAPI character format. The English and Chinese phoneme character string will be space-separated. The Japanese phoneme character string will be continuous. See the individual entries for more details about the character sets.

Syntax

HRESULT IdToPhone(
  const SPPHONEID* pId,
  WCHAR* pszPhone
);

Parameters

  • pId
    [in] Pointer to a zero-terminated array of phoneme identifiers of type SPPHONEID.
  • pszPhone
    [out] Pointer to a null-terminated string of phoneme information.

Return Value

The following table shows the possible return values.

Value Description

S_OK

Function completed successfully.

E_INVALIDARG

One or more arguments are invalid. Alternatively, pId exceeds SP_MAX_PRON_LENGTH.

E_POINTER

pszPhone or pId is invalid or bad.

SPERR_UNINITIALIZED

Interface not initialized.

E_FAIL

Member exceeds available size.

FAILED(hr)

Appropriate error message.

Requirements

Header sapi.h, sapi.idl
Library sapilib.lib
Windows Embedded CE Windows CE .NET 4.1 and later

See Also

Reference

ISpPhoneConverter
SAPI Interfaces