CRegKey Class

Этот класс содержит методы для работы с записи в реестре системы.

Важно!

Этот класс и его члены нельзя использовать в приложениях, выполняемых в этой среде выполнения Windows.

class CRegKey

Члены

Открытые конструкторы

Имя	Описание
CRegKey::CRegKey	Конструктор.
CRegKey::~CRegKey	Деструктор.

Открытые методы

Имя	Описание
CRegKey::Attach	Вызовите этот метод, чтобы вложить HKEY к объекту CRegKey с помощью маркера участника m_hKey к hKey.
CRegKey::Close	Этот метод вызывается для освобождения дескриптора элемента m_hKey и установить его на значение NULL.
CRegKey::Create	Вызывайте этот метод для создания заданным ключом, если она не существует, как подраздел hKeyParent.
CRegKey::DeleteSubKey	Вызывайте этот метод для удаления указанный ключ из реестра.
CRegKey::DeleteValue	Вызовите этот метод, чтобы удалить поле значения из m_hKey.
CRegKey::Detach	Вызывайте этот метод для удаления дескриптора элемента, наконец m_hKey из объекта CRegKey и set m_hKey значение NULL.
CRegKey::EnumKey	Вызовите этот метод, чтобы выполнить перечисление подразделов открытого раздела реестра.
CRegKey::Flush	Вызовите этот метод, чтобы записать все атрибуты открытого раздела реестра в реестр.
CRegKey::GetKeySecurity	Вызывайте этот метод для извлечения копией дескриптора безопасности, защищая открыть раздел реестра.
CRegKey::NotifyChangeKeyValue	Этот метод уведомляет вызывающий об изменениях к атрибутам или содержимое открытого раздела реестра.
CRegKey::Open	Вызовите этот метод, чтобы открыть указанный ключ и set m_hKey на маркер этого ключа.
CRegKey::QueryBinaryValue	Этот метод вызывается для получения двоичных данных для имени указанного значения.
CRegKey::QueryDWORDValue	Этот метод вызывается для получения данных DWORD для имени указанного значения.
CRegKey::QueryGUIDValue	Вызывайте этот метод для извлечения сведений о GUID для имени указанного значения.
CRegKey::QueryMultiStringValue	Вызывайте этот метод для извлечения сведений о multistring для имени указанного значения.
CRegKey::QueryQWORDValue	Вызывайте этот метод для извлечения сведений о QWORD для имени указанного значения.
CRegKey::QueryStringValue	Вызовите этот метод, чтобы получить данные строк для имени указанного значения.
CRegKey::QueryValue	Этот метод вызывается для получения данных для поля указанного значения m_hKey. Более ранние версии этого метода более не поддерживаются и не помечены как ATL_DEPRECATED.
CRegKey::RecurseDeleteKey	Вызывайте этот метод для удаления указанный ключ из реестра и явно удалить все подразделов.
CRegKey::SetBinaryValue	Вызывайте этот метод для задания бинарный значение раздела реестра.
CRegKey::SetDWORDValue	Вызовите этот метод, чтобы установить значение DWORD раздела реестра.
CRegKey::SetGUIDValue	Вызовите этот метод, чтобы установить значение GUID раздела реестра.
CRegKey::SetKeySecurity	Вызовите этот метод, чтобы установить безопасность раздела реестра.
CRegKey::SetKeyValue	Этот метод вызывается для хранения данных в поле указанного значения заданного ключа.
CRegKey::SetMultiStringValue	Вызовите этот метод, чтобы установить значение multistring раздела реестра.
CRegKey::SetQWORDValue	Вызовите этот метод, чтобы установить значение QWORD раздела реестра.
CRegKey::SetStringValue	Вызовите этот метод, чтобы задать строковое значение раздела реестра.
CRegKey::SetValue	Этот метод вызывается для хранения данных в поле указанного значения m_hKey. Более ранние версии этого метода более не поддерживаются и не помечены как ATL_DEPRECATED.

Открытые операторы

Имя	Описание
CRegKey::operator HKEY	Преобразует объект CRegKey к HKEY.
CRegKey::operator =	Оператор присваивания.

Открытые члены данных

Имя	Описание
CRegKey::m_hKey	Содержит дескриптор раздела реестра, связанного с объектом CRegKey.
CRegKey::m_pTM	Указатель на объект CAtlTransactionManager

Заметки

CRegKey предоставляет методы для создания и удаление ключей и значений в реестре системы. Реестр содержит набор установка- для конкретных определений элементов системы, например номера версии программы, логически-к- физические сопоставления задания оборудования и COM-объект.

CRegKey обеспечивает интерфейс программирования реестру системы для данного компьютера. Например, чтобы открыть указанный раздел реестра, вызов CRegKey::Open. Извлекать или изменять значение данных, вызовите CRegKey::QueryValue или CRegKey::SetValue соответственно. Закрыть ключ, вызовите CRegKey::Close.

Если закрыть ключ, его данные реестра записаны (потопленный) на жесткий диск. Этот процесс может занять несколько секунд. Если приложение должно явно записывать данные реестра на жесткий диск, можно вызвать функцию RegFlushKey Win32. Однако RegFlushKey использует много системных ресурсов и только после вызываются должно быть совершенно обязательный.

Примечание по безопасности
Все методы, позволяющие вызывающему объекту, чтобы определить расположение в реестре имеет возможность считывать данные, которые нельзя доверять.Методы, которые используют RegQueryValueEx принять во внимание, что эта функция не обрабатывает строки, которые явно завершенных NULL.Оба условия должны иметь проверены для вызывающего кода.

Требования

Header: atlbase.h

См. также

Ссылки

Registry Overview

Registry Functions

Registry Value Types

Основные понятия

Образец DCOM

Другие ресурсы

ATL Class Overview