Share via


ISpPhraseBuilder::InitFromPhrase (SAPI 5.3)

Microsoft Speech API 5.3

ISpPhraseBuilder::InitFromPhrase

ISpPhraseBuilder::InitFromPhrase initializes from a phrase.

  
    HRESULT InitFromPhrase(
   const   SPPHRASE   *pSrcPhrase
);

Parameters

  • pSrcPhrase
    Address of a SPPHRASE data structure containing the phrase information. If pSrcPhrase is NULL, the object is reset to its initial state.

Return values

Value
S_OK
E_INVALIDARG
FAILED(hr)

Example

The following code snippet demonstrates creating and initializing from a phrase.


// Declare local identifiers:
HRESULT                    hr = S_OK;
CComPtr<ISpPhraseBuilder>  cpPhraseBuilder;
CComPtr<ISpPhrase>         cpPhrase;
SPPHRASE                   Phrase;

hr = cpPhraseBuilder.CoCreateInstance(CLSID_SpPhraseBuilder);

if (SUCCEEDED(hr)) { // Initialize the Phrase data structure. hr = cpPhraseBuilder->InitFromPhrase(&Phrase;); }

if (SUCCEEDED(hr)) { // Do stuff here. }