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

Задает двоичное значение в базе данных кластера.

Синтаксис

DWORD ResUtilSetBinaryValue(
  [in]                HKEY         hkeyClusterKey,
  [in]                LPCWSTR      pszValueName,
  [in]                const LPBYTE pbNewValue,
  [in]                DWORD        cbNewValueSize,
  [in, out, optional] LPBYTE       *ppbOutValue,
  [in, out]           LPDWORD      pcbOutValueSize
);

Параметры

[in] hkeyClusterKey

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

[in] pszValueName

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

[in] pbNewValue

Указатель на новое двоичное значение.

[in] cbNewValueSize

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

[in, out, optional] ppbOutValue

Адрес указателя на новое двоичное значение.

[in, out] pcbOutValueSize

Указатель на DWORD , в котором возвращается размер в байтах значения, на которое указывает ppbOutValue .

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

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

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

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

Комментарии

Служебная функция ResUtilSetBinaryValue выделяет память для указателя ppbOutValue с помощью функции LocalAlloc, вызывает функцию API кластераClusterRegSetValue, а затем копирует новое значение в этот буфер. Если указатель не равен NULL, ResUtilSetBinaryValue также освобождает его. Как вызывающие эту функцию вы несете ответственность за освобождение буфера с помощью функции LocalFree.

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

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

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

Требования

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

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

ClusterRegSetValue

ResUtilSetDwordValue

ResUtilSetExpandSzValue

ResUtilSetMultiSzValue

ResUtilSetSzValue