This method gets the current transcript. The string retrieved will be allocated by CoTaskMemAlloc. Applications implementing this method must call CoTaskMemFree to free memory associated with this string.
HRESULT GetTranscript(WCHAR** ppszTranscript);
Parameters
- ppszTranscript
[out] Address of a pointer to the transcription string.
Return Values
The following table shows the possible return values.
| Value | Description |
|---|---|
| S_OK | Function completed successfully. ppszTranscript contains a string allocated by CoTaskMemAlloc. |
| E_OUTOFMEMORY | Exceeded available memory. |
| SPERR_UNINITIALIZED | Object has not been initialized. |
| E_POINTER | ppszTranscript is bad or invalid. |
| S_FALSE | No transcript is present and ppszTranscript will be NULL. |
| FAILED(hr) | Appropriate error message. |
Example
The following code snippet illustrates the use of this method.
HRESULT hr = S_OK;
// Bind a stream to an existing wavefile
hr = SPBindToFile( FILENAME, SPFM_READ_ONLY, &cpStream);
// Check hr
hr = cpStream.QueryInterface(&cpTranscript);
// Check hr
PWCHAR pwszTranscript;
hr = cpTranscript->GetTranscript(&pwszTranscript);
// Check hr
Requirements
OS Versions: Windows CE .NET 4.1 and later.
Header: Sapi.h, Sapi.idl.
Link Library: Sapilib.lib.
See Also
ISpTranscript | SAPI Interfaces
Send Feedback on this topic to the authors