다음을 통해 공유


CRegKey Class

이 클래스 항목에서 시스템 레지스트리를 조작 하기 위한 메서드를 제공 합니다.

중요

런타임에서 Windows를 실행 하는 응용 프로그램에서이 클래스와 해당 멤버를 사용할 수 없습니다.

class CRegKey

Members

Public 생성자

이름

설명

CRegKey::CRegKey

생성자입니다.

CRegKey::~CRegKey

소멸자

Public 메서드

이름

설명

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 개체 및 설정 m_hKey NULL로.

CRegKey::EnumKey

열린 레지스트리 키의 하위 키 열거 하려면이 메서드를 호출 합니다.

CRegKey::Flush

열린 레지스트리 키의 특성을 모두 레지스트리에 쓸이 메서드를 호출 합니다.

CRegKey::GetKeySecurity

열기 레지스트리 키를 보호 하는 보안 설명자의 복사본을 검색 하려면이 메서드를 호출 합니다.

CRegKey::NotifyChangeKeyValue

이 메서드는 특성 또는 열린 레지스트리 키의 내용을 변경 하는 방법에 대 한 호출자에 게를 알립니다.

CRegKey::Open

지정 된 키를 열고 설정 하려면이 메서드를 호출 합니다. 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.

Public 연산자

이름

설명

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 종료 문자열을 명시적으로 처리 하지 않는 고려해 야 합니다.두 조건에 대 한 호출 코드에서 확인 하 여

요구 사항

헤더: atlbase.h

참고 항목

참조

Registry Overview

Registry Functions

Registry Value Types

개념

DCOM 샘플

기타 리소스

ATL Class Overview