Функция ResUtilSetExpandSzValue (resapi.h)

Задает расширяемое строковое значение в базе данных кластера. Тип PRESUTIL_SET_EXPAND_SZ_VALUE определяет указатель на эту функцию.

Синтаксис

DWORD ResUtilSetExpandSzValue(
  [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.

Если операция завершается сбоем, функция возвращает код системной ошибки. Ниже приведен возможный код ошибки.

Код возврата	Описание
ERROR_NOT_ENOUGH_MEMORY	При попытке выделить память произошла ошибка.

Комментарии

Служебная функция ResUtilSetExpandSzValue выделяет память для нового значения и вызывает функцию API кластераClusterRegSetValue.

Расширяемое строковое значение содержит данные, представляющие строку Юникода, завершающуюся null, которая содержит нерасширенные ссылки на переменные среды, такие как "%SystemRoot%".

Не забудьте вызвать LocalFree для *ppszOutValue , чтобы избежать утечки памяти.

Не вызывайте ResUtilSetExpandSzValue из следующих функций точки входа библиотеки DLL ресурсов:

• Закрыть
• В отключенном режиме
• Справка в Интернете
• Открыть
• Завершение

ResUtilSetExpandSzValue можно безопасно вызывать из любой другой функции точки входа DLL ресурсов или из рабочего потока. Дополнительные сведения см. в разделе Вызовы функций, которые следует избегать в библиотеках DLL ресурсов.

Требования

Требование	Значение
Минимальная версия клиента	Ни одна версия не поддерживается
Минимальная версия сервера	Windows Server 2008 Корпоративная, Windows Server 2008 Datacenter
Целевая платформа	Windows
Header	resapi.h
Библиотека	ResUtils.lib
DLL	ResUtils.dll

См. также раздел

ClusterRegSetValue

ResUtilSetBinaryValue

ResUtilSetDwordValue

ResUtilSetMultiSzValue

ResUtilSetSzValue