Microsoft Speech SDK
SAPI 5.1
ISpRegDataKey::SetKey
ISpRegDataKey::SetKey sets the hive registry key (HKEY) to use for subsequent token operations.
HRESULT SetKey(
HKEY hkey,
BOOL fReadOnly
);
Parameters
- hkey
- [in] The registry key to use.
- fReadOnly
- [in] Boolean flag setting the keys to read/write status. If TRUE, the registry is read only; FALSE sets it to read and write.
Return values
| Value | Description |
|---|---|
| S_OK | Function completed successfully. |
| SPERR_ALREADY_INITIALIZED | Interface is already initialized. |
Example
The following code snippet adds, tests and deletes a superfluous key from the speech registry.
HRESULT hr;
CComPtr<ISpRegDataKey> cpSpRegDataKey;
CComPtr<ISpDataKey> cpSpCreatedDataKey;
CComPtr<ISpDataKey> cpSpDataKey;
CComPtr<ISpObjectTokenCategory> cpSpCategory;
HKEY hkey;
//create a bogus key under Voices
hr = g_Unicode.RegCreateKeyEx(HKEY_LOCAL_MACHINE, L"SOFTWARE\\Microsoft\\Speech\\Voices\\bogus", 0, NULL, 0, KEY_READ | KEY_WRITE, NULL, &hkey, NULL);
//Check error
hr = cpSpRegDataKey.CoCreateInstance(CLSID_SpDataKey);
//Check error
hr = cpSpRegDataKey->SetKey(hkey, false);
//Check error
hkey = NULL;
//Do not need to do RegCloseKey on this hkey, the handle gets released inside SetKey().
hr = cpSpRegDataKey->QueryInterface(&cpSpCreatedDataKey);
//Check error
//delete this bogus key
hr = SpGetCategoryFromId(SPCAT_VOICES, &cpSpCategory);
//Check error
hr = cpSpCategory->GetDataKey(SPDKL_LocalMachine, &cpSpDataKey);
//Check error
hr = cpSpDataKey->DeleteKey(L"bogus");
//Check error