CRegKey Class

Diese Klasse stellt Methoden zum Bearbeiten von Einträgen in der Systemregistrierung bereit.

Wichtig

Diese Klasse und ihre Member können in Anwendungen nicht verwendet werden, die in der Windows Runtime ausführen.

class CRegKey

Mitglieder

Öffentliche Konstruktoren

Name	Description
CRegKey::CRegKey	Der -Konstruktor.
CRegKey::~CRegKey	Der Destruktor.

Öffentliche Methoden

Name	Description
CRegKey::Attach	Rufen Sie diese Methode auf, um ein HKEY zum CRegKey-Objekt anzufügen, indem Sie das m_hKey-Memberhandle zu hKey festlegen.
CRegKey::Close	Rufen Sie diese Methode auf, um das m_hKey-Memberhandle freizugeben und es festzulegen, um auf NULL.
CRegKey::Create	Rufen Sie diese Methode auf, um den angegebenen Schlüssel zu erstellen, wenn er nicht als Unterschlüssel von hKeyParent vorhanden ist.
CRegKey::DeleteSubKey	Rufen Sie diese Methode auf, um den angegebenen Schlüssel aus der Registrierung zu entfernen.
CRegKey::DeleteValue	Rufen Sie diese Methode auf, um ein Wertsfeld von m_hKey zu entfernen.
CRegKey::Detach	Rufen Sie diese Methode auf, um das m_hKey-Memberhandle vom CRegKey-Objekt und Menge m_hKey zu trennen zur NULL.
CRegKey::EnumKey	Rufen Sie diese Methode auf, um die Unterschlüssel des offenen Registrierungsschlüssels aufzulisten.
CRegKey::Flush	Rufen Sie diese Methode auf, um alle Attribute des geöffneten Registrierungsschlüssels in die Registrierung zu schreiben.
CRegKey::GetKeySecurity	Rufen Sie diese Methode auf, um eine Kopie der Sicherheitsbeschreibung abzurufen, die den geöffneten Registrierungsschlüssel schützt.
CRegKey::NotifyChangeKeyValue	Diese Methode benachrichtigt den Aufrufer über Änderungen an den Attributen oder am Inhalt des offenen Registrierungsschlüssels.
CRegKey::Open	Rufen Sie diese Methode auf, um den angegebenen Schlüssel und Festlegen m_hKey in Anspruch dieser Schlüssel zu öffnen.
CRegKey::QueryBinaryValue	Rufen Sie diese Methode auf, um die Binärdaten für einen bestimmten Wertnamen abzurufen.
CRegKey::QueryDWORDValue	Rufen Sie diese Methode auf, um die DWORD-Daten für einen angegebenen Wertnamen abzurufen.
CRegKey::QueryGUIDValue	Rufen Sie diese Methode auf, um die GUIDdaten für einen angegebenen Wertnamen abzurufen.
CRegKey::QueryMultiStringValue	Rufen Sie diese Methode auf, um die Daten der mehrteiligen Zeichenfolge für einen angegebenen Wertnamen abzurufen.
CRegKey::QueryQWORDValue	Rufen Sie diese Methode auf, um die QWORDdaten für einen angegebenen Wertnamen abzurufen.
CRegKey::QueryStringValue	Rufen Sie diese Methode auf, um die Zeichenfolgendaten für einen angegebenen Wertnamen abzurufen.
CRegKey::QueryValue	Rufen Sie diese Methode auf, um die Daten für das angegebene Wertsfeld von m_hKey abzurufen. Frühere Versionen dieser Methode werden nicht mehr unterstützt und werden als ATL_DEPRECATED markiert.
CRegKey::RecurseDeleteKey	Rufen Sie diese Methode auf, um den angegebenen Schlüssel aus der Registrierung zu entfernen und alle Unterschlüssel explizit zu entfernen.
CRegKey::SetBinaryValue	Rufen Sie diese Methode auf, um den Binärwert des Registrierungsschlüssels festzulegen.
CRegKey::SetDWORDValue	Rufen Sie diese Methode auf, um den DWORD-Wert des Registrierungsschlüssels festzulegen.
CRegKey::SetGUIDValue	Rufen Sie diese Methode auf, um den GUID-Wert des Registrierungsschlüssels festzulegen.
CRegKey::SetKeySecurity	Rufen Sie diese Methode auf, um die Sicherheit des Registrierungsschlüssels festzulegen.
CRegKey::SetKeyValue	Rufen Sie diese Methode auf, um Daten auf einem angegebenen Wertsgebiet eines angegebenen Schlüssels zu speichern.
CRegKey::SetMultiStringValue	Rufen Sie diese Methode auf, um den Wert der mehrteiligen Zeichenfolge des Registrierungsschlüssels festzulegen.
CRegKey::SetQWORDValue	Rufen Sie diese Methode auf, um den QWORDwert des Registrierungsschlüssels festzulegen.
CRegKey::SetStringValue	Rufen Sie diese Methode auf, um den Zeichenfolgenwert des Registrierungsschlüssels festzulegen.
CRegKey::SetValue	Rufen Sie diese Methode auf, um Daten auf dem angegebenen Wertsgebiet von m_hKey zu speichern. Frühere Versionen dieser Methode werden nicht mehr unterstützt und werden als ATL_DEPRECATED markiert.

Öffentliche Operatoren

Name	Description
CRegKey::operator HKEY	Konvertiert ein Objekt CRegKey zu einem HKEY.
CRegKey::operator =	Zuweisungsoperator

Öffentliche Datenmember

Name	Description
CRegKey::m_hKey	Enthält ein Handle des Registrierungsschlüssels, der mit dem CRegKey-Objekt zugeordnet ist.
CRegKey::m_pTM	Zeiger auf CAtlTransactionManager-Objekt

Hinweise

CRegKey stellt Methoden zum Erstellen und Löschen von Schlüsseln und von Werten in der Systemregistrierung bereit. Die Registrierung enthält ein Installationbesonderen, das von den Definitionen für Systemkomponenten, wie Softwareversionszahlen, Logisch-zusystemtest Zuordnungen der installierten Hardware und COM-Objekte festgelegt ist.

CRegKey stellt eine Programmierschnittstelle für die Systemregistrierung für einen angegebenen Computer bereit. Beispielsweise einen bestimmten Registrierungsschlüssel öffnen, Aufruf CRegKey::Open. So fügen Sie einen Datenwert, einen Aufruf CRegKey::QueryValue oder CRegKey::SetValue abrufen oder ändern, bzw. Um eine Schlüssel zu schließen, rufen Sie CRegKey::Close auf.

Wenn Sie einen Schlüssel schließen, werden die Registrierungsdaten auf die Festplatte geschrieben (geleert). Dieser Prozess erfordert möglicherweise einige Sekunden. Wenn die Anwendung Registrierungsdaten explizit auf die Festplatte schreiben muss, können Sie die Funktion RegFlushKey Win32 aufrufen. verwendet jedoch RegFlushKey viele Systemressourcen und sollte nur aufgerufen werden, wenn es unbedingt erforderlich ist.

Sicherheitshinweis
Alle Methoden, die dem Aufrufer ermöglichen, einen Registrierungsspeicherort anzugeben, haben die Möglichkeit, Daten zu lesen, die nicht vertrauenswürdig sind.Methoden, die RegQueryValueEx verwendet wird, sollten in Erwägung ziehen, dass diese Funktion nicht explizit Zeichenfolgen behandelt, die beendet NULL sind.Beide Bedingungen sollten für durch den Aufrufcode überprüft werden.

Anforderungen

Header: atlbase.h

Siehe auch

Referenz

Registry Overview

Registry Functions

Registry Value Types

Konzepte

Beispiel für DCOM

Weitere Ressourcen

ATL Class Overview