CRegKey::SetValue
Этот метод вызывается для хранения данных в поле указанного значения m_hKey. Более ранние версии этого метода более не поддерживаются и не помечены как ATL_DEPRECATED.
LONG SetValue(
LPCTSTR pszValueName,
DWORD dwType,
const void* pValue,
ULONG nBytes
) throw( );
static LONG WINAPI SetValue(
HKEY hKeyParent,
LPCTSTR lpszKeyName,
LPCTSTR lpszValue,
LPCTSTR lpszValueName = NULL);
ATL_DEPRECATED LONG SetValue(
DWORD dwValue,
LPCTSTR lpszValueName
);
ATL_DEPRECATED LONG SetValue(
LPCTSTR lpszValue,
LPCTSTR lpszValueName = NULL,
bool bMulti = false,
int nValueLen = -1
);
Параметры
pszValueName
Указатель на строку, содержащую имя значения в набор. Если значение с таким именем еще нет в ключе, то метод добавляет его к ключу. Если pszValueName, значение NULL или пустая строка (""), то метод задают тип ключа и данные для безымянного или значения по умолчанию.dwType
Указывает код, указывающий тип данных, указанных в параметрах pValue.pValue
Указатель на буфер, содержащий сохраняемые данные с использованием указанного значения.nBytes
Указывает размер в байтах, заданного в параметре pValue сведения. Если данные типа REG_SZ в REG_EXPAND_SZ или REG_MULTI_SZ, то nBytes должно включать размер конечного нуль-символа.hKeyParent
Маркер открытого ключа.lpszKeyName
Указывает имя открытого ключа, который требуется создать. Это имя должно быть hKeyParent подразделом.lpszValue
Определяет сохраняемые данные. Этот параметр не должен иметь значение NULL.lpszValueName
Определяет поле значение, которое необходимо установить. Если поле значения с таким именем еще не существует ключа, то он добавлено.dwValue
Определяет сохраняемые данные.bMulti
Если false, указывающее на то, что строка типа REG_SZ. Значение true указывает, что строка типа multistring REG_MULTI_SZ.nValueLen
Если bMulti значение равно true, то nValueLen длина строки lpszValue в символах. Если bMulti false, то значение -1 указывает, что метод вычислит размер автоматически.
Возвращаемое значение
Если успешно, передачи ERROR_SUCCESS; в противном случае – значение ненулевой код ошибки, заданный в атрибуте WINERROR.H.
Заметки
2 Исходной версии SetValue помечены как ATL_DEPRECATED и должны быть больше не используются. Компилятор выводит предупреждение, если эти формы используются.
Третье вызовы метода RegSetValueEx.
Требования
Header: atlbase.h