Функция ClusterRegSetValue (clusapi.h)

Статья
08/22/2023

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

Синтаксис

DWORD ClusterRegSetValue(
  [in] HKEY       hKey,
  [in] LPCWSTR    lpszValueName,
  [in] DWORD      dwType,
  [in] const BYTE *lpData,
  [in] DWORD      cbData
);

Параметры

[in] hKey

Обработка ключа базы данных кластера.

[in] lpszValueName

Указатель на строку Юникода, завершающуюся null, которая содержит имя устанавливаемого значения. Если значение с таким именем отсутствует в ресурсе, ClusterRegSetValue добавляет его в ресурс.

[in] dwType

Тип сведений, которые будут храниться в качестве данных значения. Этот параметр может принимать одно из указанных ниже значений. Дополнительные сведения см. в разделе Типы значений реестра.

REG_BINARY (3)

Двоичные данные в любой форме.

REG_DWORD (4)

32-разрядное число.

REG_DWORD_BIG_ENDIAN (5)

32-разрядное число, хранящееся в формате big-endian.

REG_EXPAND_SZ (2)

Строка Юникода, завершающаяся null, которая содержит нерасширенные ссылки на переменные среды (например, "%PATH%").

REG_MULTI_SZ (6)

Последовательность строк, заканчивающихся значением NULL, которая завершается пустой строкой (\0).

Ниже представлен пример такого кода:

String1\0String2\0String3\0LastString\0\0

Первый \0 завершает первую строку, второй к последней \0 завершает последнюю строку, а последний \0 завершает последовательность. Обратите внимание, что окончательный признак конца должен учитываться в длине строки.

REG_NONE (0)

Нет определенного типа значения.

REG_QWORD (11)

64-разрядное число.

REG_SZ (1)

Строка Юникода, заканчивающаяся null.

[in] lpData

Указатель на хранимые данные с именем, на который указывает lpszValueName.

[in] cbData

Количество байтов в данных, на которые указывает параметр lpbData . Если данные имеют тип REG_SZ, REG_EXPAND_SZ или REG_MULTI_SZ, cbData должен включать размер символа, завершающего значение NULL.

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

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

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

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

Требования


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

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

ClusterRegOpenKey

Getlasterror

Поделиться через