ISpGrammarBuilder::AddResource (Windows CE 5.0)
This method adds a resource (name and string value) to the specified grammar rule. 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 to add the resource. - pszResourceName
[in] Pointer to a null-terminated string specifying the resource name. - pszResourceValue
[in] Pointer to a null-terminated string specifying the resource value.
Return Values
The following table shows the possible 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 example illustrates the use of this method.
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.
Requirements
OS Versions: Windows CE .NET 4.1 and later.
Header: Sapi.h, Sapi.idl.
Link Library: Sapilib.lib.
See Also
ISpGrammarBuilder | SAPI Interfaces
Send Feedback on this topic to the authors