Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
This method gets the recognition context object that is associated with this result.
HRESULT GetRecoContext(ISpRecoContext** ppRecoContext);
Parameters
- ppRecoContext
[out] Address of a pointer to an object implementing ISpRecoContext. The caller must call IUnknown::Release on the references when it is finished with the object.
Return Values
The following table shows the possible return values.
| Value | Description |
|---|---|
| S_OK | Function completed successfully. |
| E_POINTER | ppRecoContext is invalid or bad. |
| FAILED(hr) | Appropriate error message. |
Example
The following code snippet illustrates the use of this method to retrieve a reference to the ISpRecoContext instance that is associated with a recognized phrase and determine the maximum number of CFG alternates that can be generated for it.
HRESULT hr = S_OK;
DWORD dwMaxAlternates;
// ... obtain a recognition result object from the recognizer...
// get the associated ISpRecoContext
hr = cpRecoResult->GetRecoContext(&cpRecoContext);
// Check hr
hr = cpRecoContext->GetMaxAlternates(&dwMaxAlternates);
// Check hr
Requirements
OS Versions: Windows CE .NET 4.1 and later.
Header: Sapi.h, Sapi.idl.
Link Library: Sapilib.lib.
See Also
ISpRecoResult | SAPI Interfaces
Send Feedback on this topic to the authors