Sdílet prostřednictvím


Třída CRegKey

Tato třída poskytuje metody pro práci s položkami v systémovém registru.

Důležitá poznámkaDůležité

Třídy a jejích členů nelze použít v aplikacích, které spustit v modulu Runtime v systému Windows.

class CRegKey

Členy

Veřejné konstruktory

Název

Description

CRegKey::CRegKey

Konstruktor.

CRegKey:: ~ CRegKey

Destruktoru.

Veřejné metody

Název

Description

CRegKey::Attach

Volání této metody připojit HKEY na CRegKey objektu nastavením m_hKey úchytu členského hKey .

CRegKey::Close

Volání této metody uvolnění m_hKey zpracování a nastavit na hodnotu NULL.

CRegKey::Create

Pokud neexistuje jako podklíč volání této metody vytvořit zadaný klíč hKeyParent .

CRegKey::DeleteSubKey

Volání této metody odebrat zadaný klíč z registru.

CRegKey::DeleteValue

Volání této metody odeberete pole z hodnoty m_hKey.

CRegKey::Detach

Volání této metody odpojit m_hKey člen popisovače z CRegKey objektu a nastavit m_hKey na hodnotu NULL.

CRegKey::EnumKey

Volání této metody výčet podklíčů klíče registru otevřít.

CRegKey::Flush

Volání této metody zapsat všechny atributy otevřít klíč registru do registru.

CRegKey::GetKeySecurity

Volání této metody načíst popisovač zabezpečení ochrany klíče registru otevřít kopii.

CRegKey::NotifyChangeKeyValue

Tato metoda upozorní volajícího o změny atributů nebo obsah klíče otevřít registr.

CRegKey::Open

Volání této metody otevřít zadaný klíč a nastavit m_hKey ke zpracování tohoto klíče.

CRegKey::QueryBinaryValue

Volání této metody načíst binární data zadaná hodnota název.

CRegKey::QueryDWORDValue

Tato metoda načítání dat DWORD pro zadanou hodnotu názvu volání.

CRegKey::QueryGUIDValue

Tato metoda načítání dat GUID pro zadanou hodnotu názvu volání.

CRegKey::QueryMultiStringValue

Volání této metody k načtení dat nahrazován název zadané hodnoty.

CRegKey::QueryQWORDValue

Tato metoda načítání dat QWORD pro zadanou hodnotu názvu volání.

CRegKey::QueryStringValue

Tato metoda načítání dat řetězce pro zadanou hodnotu názvu volání.

CRegKey::QueryValue

Tato metoda načítání dat pro pole Zadaná hodnota volání m_hKey.Dřívější verze této metody již nejsou podporovány a jsou označeny jako ATL_DEPRECATED.

CRegKey::RecurseDeleteKey

Volání této metody zadaný klíč z registru odebrat a explicitně odebrat všechny podklíče.

CRegKey::SetBinaryValue

Volání této metody na binární hodnotu klíče registru.

CRegKey::SetDWORDValue

Volání této metody, nastavte hodnotu DWORD klíče registru.

CRegKey::SetGUIDValue

Voláním metody tohoto klíče registru hodnotu GUID.

CRegKey::SetKeySecurity

Volání této metody nastavení zabezpečení klíče registru.

CRegKey::SetKeyValue

Volání této metody k ukládání dat v poli zadanou hodnotu zadaného klíče.

CRegKey::SetMultiStringValue

Volání této metody nahrazován hodnotu klíče registru.

CRegKey::SetQWORDValue

Volání této metody nastavení hodnota QWORD klíče registru.

CRegKey::SetStringValue

Volání této metody nastavení klíče registru hodnotu řetězce.

CRegKey::SetValue

Volání této metody k ukládání dat v poli zadanou hodnotu m_hKey.Dřívější verze této metody již nejsou podporovány a jsou označeny jako ATL_DEPRECATED.

Veřejné operátory

Název

Description

CRegKey::operator HKEY

Převede CRegKey objekt HKEY.

CRegKey::operator =

Operátor přiřazení.

Veřejné datové členy

Název

Description

CRegKey::m_hKey

Popisovač klíče registru související s obsahuje CRegKey objektu.

CRegKey::m_pTM

Ukazatel na CAtlTransactionManager objekt

Poznámky

CRegKeyposkytuje metody pro vytvoření a odstranění klíčů a hodnot v registru systému.Registr obsahuje sadu instalace specifických definic pro součásti systému, například čísla verzí softwaru, mapování logické fyzické nainstalovaný hardware a objekty COM.

CRegKeyposkytuje rozhraní pro programování v systémovém registru pro daný počítač.Například otevřít klíč registru zejména, volání CRegKey::Open .Volání k načtení nebo upravit hodnotu dat, CRegKey::QueryValue nebo CRegKey::SetValue , resp..Zavřít klíč, volání CRegKey::Close .

Při zavírání klíče registru data je zápis na disk.Tento proces může trvat několik sekund.Pokud vaše aplikace musí zapsat data registru explicitně na pevný disk, můžete volat RegFlushKey funkci Win32.Však RegFlushKey používá mnoho systémových prostředků a by měla být volána pouze v krajním případě.

Poznámka k zabezpečeníPoznámka k zabezpečení

Všechny metody, které umožňují volajícímu zadat umístění registru mají potenciál číst data, která nelze důvěřovat.Použití metod, které RegQueryValueEx brát v úvahu, že tato funkce nezpracovává explicitně řetězců, které jsou zakončeny znakem NULL.Obě podmínky by měly být kontrolovány volající kód.

Požadavky

Záhlaví: atlbase.h

Viz také

Referenční dokumentace

Registry Overview

Registry Functions

Registry Value Types

Koncepty

Ukázkový model DCOM

Další zdroje

Přehled třídy ATL