Функция ResUtilSetSzValue (resapi.h)
Задает строковое значение в базе данных кластера. Тип PRESUTIL_SET_SZ_VALUE определяет указатель на эту функцию.
Синтаксис
DWORD ResUtilSetSzValue(
[in] HKEY hkeyClusterKey,
[in] LPCWSTR pszValueName,
[in] LPCWSTR pszNewValue,
[in, out, optional] LPWSTR *ppszOutString
);
Параметры
[in] hkeyClusterKey
Ключ, определяющий расположение строкового значения в базе данных кластера.
[in] pszValueName
Строка Юникода, заканчивающаяся значением NULL, содержащая имя обновляемого значения.
[in] pszNewValue
Указатель на новое строковое значение.
[in, out, optional] ppszOutString
Указатель на строковый указатель, получающий копию обновленного значения. Если используется, вызывающие стороны должны вызывать LocalFree в *ppszOutValue.
Возвращаемое значение
Если операция выполнена успешно, функция возвращает ERROR_SUCCESS.
Если операция завершается сбоем, функция возвращает код системной ошибки. Ниже приведен возможный код ошибки.
| Код возврата | Описание |
|---|---|
|
При попытке выделить память произошла ошибка. |
Комментарии
Служебная функция ResUtilSetSzValue выделяет память для нового значения и вызывает функцию API кластераClusterRegSetValue. При необходимости освобождается предыдущее значение. Новое значение копируется в содержимое ppszOutValue.
Не забудьте вызвать LocalFree для *ppszOutValue , чтобы избежать утечки памяти.
Не вызывайте ResUtilSetSzValue из следующих функций точки входа dll ресурсов:
ResUtilSetSzValue можно безопасно вызывать из любой другой функции точки входа dll ресурсов или из рабочего потока. Дополнительные сведения см. в разделе Вызовы функций, которые следует избегать в библиотеках DLL ресурсов.Требования
| Минимальная версия клиента | Ни одна версия не поддерживается |
| Минимальная версия сервера | Windows Server 2008 Корпоративная, Windows Server 2008 Datacenter |
| Целевая платформа | Windows |
| Header | resapi.h |
| Библиотека | ResUtils.lib |
| DLL | ResUtils.dll |