Microsoft Speech SDK SAPI 5.1

---

ISpLexicon::GetPronunciations

ISpLexicon::GetPronunciations gets pronunciations and parts of speech for a word.

HRESULT GetPronunciations(
   const WCHAR              *pszWord,
   LANGID                    LangID,
   DWORD                     dwFlags,
   SPWORDPRONUNCIATIONLIST  *pWordPronunciationList
);

Parameters

pszWord

[in] Pointer to a null-terminated text string as a search keyword. Length must be equal to less than SP_MAX_WORD_LENGTH.

LangID

[in] The language ID of the word. May be zero to indicate that the word can be of any LANGID.

dwFlags

[in] Bitwise flags of type SPLEXICONTYPE indicating that the lexicons searched for this word.

pWordPronunciationList

[in, out] Pointer to SPWORDPRONUNCIATIONLIST structure in which the pronunciations and parts of speech are returned.

Return values

Value	Description
S_OK	Function completed successfully.
SP_WORD_EXISTS_WITHOUT_PRONUNCIATION	The word exists but does not have a pronunciation.
E_POINTER	pWordPronunciationList is not a valid write pointer.
E_INVALIDARG	At least one of the parameters is invalid or bad.
E_OUTOFMEMORY	Exceeded available memory.
SPERR_UNINITIALIZED	The interface has not been initialized.
SPERR_NOT_IN_LEX	Word is not found in the lexicon.
FAILED(hr)	Appropriate error message.

Example

The following example is a code fragment demonstrating the use of GetPronunciations.

        SPWORDPRONUNCIATIONLIST spwordpronlist; 
        memset(&spwordpronlist, 0, sizeof(spwordpronlist)); 
        
        hr = pISpLexicon->GetPronunciations(L"resume", 409, eLEXTYPE_USER | eLEXTYPE_APP, &spwordpronlist);
        //test for results
        if( !SUCCEEDED(hr)) return;
        
        for (
             SPWORDPRONUNCIATION pwordpron = pwordpronlist->pFirstWordPron;
             wordpron != NULL;
             wordpron = pwordpron->pNextWordPron
               )
        {
            DoSomethingWith(pwordpron->ePartOfSpeech, pwordpron->szPronunciation);
        }
        
        //free all the buffers
        CoTaskMemFree(spwordpronlist.pvBuffer);