Klasa CRegKey

Ta klasa zapewnia metody manipulowania wpisów w rejestrze systemu.

Ważne
W aplikacjach, które są wykonywane w Windows Runtime nie można użyć tej klasy i jej członków.

class CRegKey

Członkowie

Publiczne konstruktory

Nazwa	Opis
CRegKey::CRegKey	Konstruktor.
CRegKey:: ~ CRegKey	Destruktor.

Metody publiczne

Nazwa	Opis
CRegKey::Attach	Wywołanie tej metody, aby dołączyć HKEY do CRegKey obiektu ustawiając m_hKey Członkowskich dojścia do hKey.
CRegKey::Close	Wywołanie tej metody, aby zwolnić m_hKey Członkowskich uchwyt i wartość NULL.
CRegKey::Create	Wywołanie tej metody do utworzenia określonego klucza, jeśli nie istnieje jako podklucz hKeyParent.
CRegKey::DeleteSubKey	Wywołanie tej metody, aby usunąć określonego klucza z rejestru.
CRegKey::DeleteValue	Wywołanie tej metody, aby usunąć pole wartość z m_hKey.
CRegKey::Detach	Wywołanie tej metody, aby odłączyć m_hKey Członkowskich uchwyt z CRegKey obiektu i ustaw m_hKey na NULL.
CRegKey::EnumKey	Wywołanie tej metody Wyliczanie podkluczy klucza rejestru otwarte.
CRegKey::Flush	Wywołanie tej metody wszystkie atrybuty klucza rejestru otwarty zapis do rejestru.
CRegKey::GetKeySecurity	Wywołanie tej metody, aby pobrać kopię deskryptora zabezpieczeń, ochrona otworzyć klucza rejestru.
CRegKey::NotifyChangeKeyValue	Metoda ta powiadamia wywołującego o zmiany atrybutów lub zawartość otworzyć klucza rejestru.
CRegKey::Open	Wywołanie tej metody, aby otworzyć określonego klucza i ustawić m_hKey do realizacji tego klucza.
CRegKey::QueryBinaryValue	Wywołanie tej metody do pobierania danych binarnych dla nazwy określonej wartości.
CRegKey::QueryDWORDValue	Wywołanie tej metody do pobierania danych DWORD dla nazwy określonej wartości.
CRegKey::QueryGUIDValue	Wywołanie tej metody do pobierania danych identyfikator GUID dla nazwy określonej wartości.
CRegKey::QueryMultiStringValue	Wywołanie tej metody do pobierania danych nazwa określona wartość wielociągu.
CRegKey::QueryQWORDValue	Wywołanie tej metody do pobierania danych QWORD nazwy określonej wartości.
CRegKey::QueryStringValue	Wywołanie tej metody do pobierania danych ciąg nazwy określonej wartości.
CRegKey::QueryValue	Wywołanie tej metody do pobierania danych dla określonej wartości pola z m_hKey.Wcześniejsze wersje tej metody nie są już obsługiwane i są oznaczone jako ATL_DEPRECATED.
CRegKey::RecurseDeleteKey	Wywołanie tej metody do usunięcia określonego klucza z rejestru i usunąć wszystkie podklucze.
CRegKey::SetBinaryValue	Wywołanie tej metody, aby ustawić wartość binarna klucza rejestru.
CRegKey::SetDWORDValue	Wywołanie tej metody, aby ustawić wartość DWORD klucza rejestru.
CRegKey::SetGUIDValue	Wywołanie tej metody należy ustawić wartość klucza rejestru identyfikatora GUID.
CRegKey::SetKeySecurity	Wywołanie tej metody, aby ustawić zabezpieczenia klucza rejestru.
CRegKey::SetKeyValue	Wywołanie tej metody do przechowywania danych w polu określonej wartości określonego klucza.
CRegKey::SetMultiStringValue	Wywołanie tej metody, aby ustawić wartość wielociągu klucza rejestru.
CRegKey::SetQWORDValue	Wywołanie tej metody, aby ustawić wartość QWORD klucza rejestru.
CRegKey::SetStringValue	Wywołanie tej metody, aby ustawić wartość ciągu klucza rejestru.
CRegKey::SetValue	Wywołanie tej metody przechowywania danych w dziedzinie określonej wartości m_hKey.Wcześniejsze wersje tej metody nie są już obsługiwane i są oznaczone jako ATL_DEPRECATED.

Podmioty publiczne

Nazwa	Opis
CRegKey::operator HKEY	Konwertuje CRegKey obiekt HKEY.
CRegKey::operator =	Operator przypisania.

Publiczne danych członków

Nazwa	Opis
CRegKey::m_hKey	Zawiera uchwyt klucza rejestru skojarzone z CRegKey obiektu.
CRegKey::m_pTM	Wskaźnik do CAtlTransactionManager obiektu

Uwagi

CRegKeyzapewnia metody tworzenia i usuwania kluczy i wartości w rejestrze systemu.Rejestr zawiera zestaw instalacji specyficzne definicje dla składników systemu, takich jak numery wersji oprogramowania, mapowania logiczne fizycznego zainstalowany sprzęt i obiekty COM.

CRegKeyudostępnia interfejs programowania do rejestru systemowego dla danego komputera.Na przykład otworzyć klucza rejestru w szczególności, call CRegKey::Open.Pobieranie lub zmodyfikować wartości danych, wywołanie CRegKey::QueryValue lub CRegKey::SetValue, odpowiednio.Aby zamknąć klucza, wywołanie CRegKey::Close.

Podczas zamykania klucza jego dane rejestru są zapisywane (opróżniania buforów) na dysku twardym.Ten proces może zająć kilka sekund.Jeśli aplikacja musi jawnie zapisu danych rejestru na dysku twardym, można wywołać RegFlushKey funkcji Win32.Jednakże RegFlushKey używa wielu zasobów systemowych i powinna zostać wywołana tylko wtedy, gdy jest to absolutnie konieczne.

Uwaga dotycząca zabezpieczeń
Wszelkie metody, które Zezwalaj rozmówcy na określenie lokalizacji rejestru mają możliwość odczytu danych nie można zaufać.Wykorzystanie metod, które RegQueryValueEx należy wziąć pod uwagę, że ta funkcja nie obsługuje jawnie ciągów, które są zakończone znakiem NULL.Oba warunki są sprawdzane dla przez kod wywołujący.

Wymagania

Nagłówek: atlbase.h

Zobacz też

Informacje

Registry Overview

Registry Functions

Registry Value Types

Koncepcje

Próbki DCOM

Inne zasoby

Omówienie klasy ATL