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

Функция ORSetValue

  • Статья

Задает данные для значения указанного раздела реестра в автономном кусте реестра.

Синтаксис

DWORD ORSetValue(
  _In_     ORHKEY Handle,
  _In_opt_ PCWSTR lpValueName,
  _In_     DWORD  dwType,
  _In_opt_ const BYTE *lpData,
  _In_     DWORD  cbData
);

Параметры

Дескриптор [in]

Дескриптор открытого раздела реестра в автономном кусте реестра.

lpValueName [in, необязательный]

Имя устанавливаемого значения. Если значение с таким именем еще нет в ключе, функция добавляет его в ключ.

Если lpValueName имеет значение NULL или пустую строку "", функция задает тип и данные для неименованного или стандартного значения ключа.

Дополнительные сведения см. в разделе Ограничения размера элементов реестра.

Разделы реестра не имеют значений по умолчанию, но могут иметь одно неименованное значение, которое может иметь любой тип.

dwType [in]

Тип данных, на которые указывает параметр lpData . Список возможных типов см. в разделе Типы значений реестра.

lpData [in, необязательный]

Сохраняемые данные.

Для строковых типов, таких как REG_SZ, строка должна заканчиваться null. Для типа данных REG_MULTI_SZ строка должна заканчиваться двумя символами NULL.

cbData [in]

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

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

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

Если функция завершается сбоем, возвращаемое значение представляет собой ненулевой код ошибки, определенный в Winerror.h. Чтобы получить общее описание ошибки, можно использовать функцию FormatMessage с флагом FORMAT_MESSAGE_FROM_SYSTEM.

Комментарии

Размеры значений ограничены доступной памятью. Длинные значения (более 2048 байт) должны храниться в виде файлов с именами файлов, хранящимися в реестре. Это помогает эффективно работать реестру. Элементы приложения, такие как значки, растровые изображения и исполняемые файлы, должны храниться как файлы и не помещаться в реестр.

Требования

Требование Значение
Распространяемые компоненты
 Библиотека автономного реестра Windows версии 1.0 или более поздней
Заголовок
Offreg.h
DLL
Offreg.dll

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

ORCreateKey

OROpenKey