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

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

Синтаксис

DWORD ResUtilSetMultiSzValue(
  [in]                HKEY    hkeyClusterKey,
  [in]                LPCWSTR pszValueName,
  [in]                LPCWSTR pszNewValue,
  [in]                DWORD   cbNewValueSize,
  [out, optional]     LPWSTR  *ppszOutValue,
  [in, out, optional] LPDWORD pcbOutValueSize
);

Параметры

[in] hkeyClusterKey

Ключ, определяющий расположение многостроковых значений в базе данных кластера.

[in] pszValueName

Строка Юникода, заканчивающаяся значением NULL, содержащая имя обновляемого значения.

[in] pszNewValue

Указатель на новое многострочное значение.

[in] cbNewValueSize

Размер нового значения.

[out, optional] ppszOutValue

Указатель на строковый указатель, получающий копию обновленного значения. Если используется, вызывающие стороны должны вызывать LocalFree в *ppszOutValue.

[in, out, optional] pcbOutValueSize

Указатель, получающий размер нового значения.

Возвращаемое значение

Если операция выполнена успешно, функция возвращает ERROR_SUCCESS.

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

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

Комментарии

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

Значение из нескольких строк — это большая строка, содержащая небольшие, непрерывные строки Юникода, заканчивающиеся nullом и заканчивающиеся дополнительным символом NULL после последней строки.

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

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

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

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

Требования

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

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

ClusterRegSetValue

ResUtilSetBinaryValue

ResUtilSetDwordValue

ResUtilSetExpandSzValue

ResUtilSetSzValue