Export (0) Print
Expand All

ISpSREngineSite::GetResource (SAPI 5.3)

Speech API 5.3
Microsoft Speech API 5.3

ISpSREngineSite::GetResource

ISpSREngineSite::GetResource retrieves a named resource from a grammar.

HRESULT GetResource(
   SPRULEHANDLE     hRule,
   LPCWSTR         *pszResourceName,
   LPWSTR         **ppCoMemResource
);

Parameters

hRule
[in] The rule handle.
pszResourceName
[in] Null-terminated string containing the name of the resource to recover.
ppCoMemResource
[out] The resource associated with the rule. Applications calling this method must call CoTaskMemFree() to free memory associated with this resource.

Return values

ValueDescription
S_OKFunction completed successfully and the rule contained a resource of the correct name.
S_FALSEFunction completed successfully but no resource was found.
E_INVALIDARGpszResourceName points to invalid string.
E_POINTERppCoMemResource invalid or bad.
E_NOTIMPLMethod is not implemented.
SPERR_INVALID_HANDLEInvalid hRule handle.
FAILED (hr)Appropriate error message.

Remarks

Within a CFG, each rule can contain one or more named strings containing arbitrary string data. The engine can recover this data using ::GetResource and passing in the rule handle and resource name.

Show:
© 2015 Microsoft