Microsoft Speech SDK
SAPI 5.1
ISpGrammarBuilder::AddResource
ISpGrammarBuilder::AddResource adds a resource (name and string value) to the grammar rule specified in hRuleState. The resource can be queried by a rule interpreter using ISpCFGInterpreterSite::GetResourceValue().
HRESULT AddResource(
SPSTATEHANDLE hRuleState,
const WCHAR *pszResourceName,
const WCHAR *pszResourceValue
);
Parameters
- hRuleState
- [in] Handle of a state in the rule to which the resource is to be added.
- pszResourceName
- [in] Address of a null-terminated string specifying the resource name.
- pszResourceValue
- [in] Address of a null-terminated string specifying the resource value.
Return values
| Value | Description |
|---|---|
| S_OK | Function completed successfully. |
| E_INVALIDARG | At least one of the parameters is invalid. |
| SPERR_DUPLICATE_RESOURCE_NAME | The resource already exists. |
| E_OUTOFMEMORY | Exceeded available memory. |
| FAILED(hr) | Appropriate error message. |
Example
The following code snippet illustrates the use of AddResource.
HRESULT hr = S_OK;
SPSTATEHANDLE hInit;
hr = pGrammarBuilder->GetRule(L"rule1", 1, 0, TRUE, &hInit);
SPSTATEHANDLE hState;
hr = pGrammarBuilder->CreateNewState(hInit, &hState);
// Check hr
// AddResource using the hInitState
hr = pGrammarBuilder->AddResource(hInit, L"ResName1", L"ResValue1");
// Check hr
// AddResource using hState != hInit
hr = pGrammarBuilder->AddResource(hState, L"ResName2", L"ResValue2");
// Check hr