ISpPhrase::GetPhrase
.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.")
9/8/2008
Este método obtém dados elementos associado com uma frase. A memória que contém elementos de dados é alocada com um chamar para CoTaskMemAlloc.
Syntax
HRESULT GetPhrase(
SPPHRASE** ppCoMemPhrase
);
Parameters
- ppCoMemPhrase
[out] Endereço de um ponteiro para um SPPHRASE estrutura contendo informações de frase, ou para NULL se nenhuma expressão é reconhecido. Se o valor for NULL, nenhuma memória é alocada para a estrutura. É responsibilty do chamador para chamar CoTaskMemFree a livre a estrutura. No entanto, o chamador não é necessário chamar CoTaskMemFree Em cada um do SPPHRASE Os membros.
Return Value
A seguinte tabela mostra os valores possíveis de retorno.
| Value | Description |
|---|---|
S_OK |
Function completed successfully. |
E_POINTER |
Ponteiro inválido. |
E_OUTOFMEMORY |
Disponível excedido memória. |
Retornou dados inclui todos os elementos associado com essa frase.
Example
O seguinte trecho de código ilustra o uso desse método como herdadas ISpPhrase Para recuperar o texto reconhecido e exibir a regra reconhecida e a frase.
HRESULT hr = S_OK;
// ... obtain a recognition result object from the recognizer...
// get the recognized phrase object
hr = cpRecoResult->GetPhrase(&pPhrase);
// Check hr
// get the phrase's text
hr = pPhrase->GetText(SP_GETWHOLEPHRASE, SP_GETWHOLEPHRASE, TRUE, &pwszText,
NULL);
// Check hr
// display the recognized text and the rule name in a message box
MessageBoxW(MY_HWND, pwszText, pPhrase->Rule.pszName, MB_OK);
Requirements
| Header | sapi.h, sapi.idl |
| Library | sapilib.lib |
| Windows Embedded CE | Windows CE .NET 4.1 and later |