CRegKey-Klasse
Diese Klasse stellt Methoden zum Bearbeiten von Einträgen in der Systemregistrierung bereit.
.gif "Wichtiger Hinweis") Wichtig |
|---|
Diese Klasse und ihre Member können in Anwendungen nicht verwendet werden, die in der Windows Runtime ausführen. |
class CRegKey
Mitglieder
.gif "xka57xy4.collapse_all(de-de,VS.110).gif")
Öffentliche Konstruktoren
Name |
Description |
|---|---|
Der -Konstruktor. |
|
Der Destruktor. |
Öffentliche Methoden
Name |
Description |
|---|---|
Rufen Sie diese Methode auf, um ein HKEY zum CRegKey-Objekt anzufügen, indem Sie das m_hKey-Memberhandle zu hKey festlegen. |
|
Rufen Sie diese Methode auf, um das m_hKey-Memberhandle freizugeben und es festzulegen, um auf NULL. |
|
Rufen Sie diese Methode auf, um den angegebenen Schlüssel zu erstellen, wenn er nicht als Unterschlüssel von hKeyParent vorhanden ist. |
|
Rufen Sie diese Methode auf, um den angegebenen Schlüssel aus der Registrierung zu entfernen. |
|
Rufen Sie diese Methode auf, um ein Wertsfeld von m_hKey zu entfernen. |
|
Rufen Sie diese Methode auf, um das m_hKey-Memberhandle vom CRegKey-Objekt und Menge m_hKey zu trennen zur NULL. |
|
Rufen Sie diese Methode auf, um die Unterschlüssel des offenen Registrierungsschlüssels aufzulisten. |
|
Rufen Sie diese Methode auf, um alle Attribute des geöffneten Registrierungsschlüssels in die Registrierung zu schreiben. |
|
Rufen Sie diese Methode auf, um eine Kopie der Sicherheitsbeschreibung abzurufen, die den geöffneten Registrierungsschlüssel schützt. |
|
Diese Methode benachrichtigt den Aufrufer über Änderungen an den Attributen oder am Inhalt des offenen Registrierungsschlüssels. |
|
Rufen Sie diese Methode auf, um den angegebenen Schlüssel und Festlegen m_hKey in Anspruch dieser Schlüssel zu öffnen. |
|
Rufen Sie diese Methode auf, um die Binärdaten für einen bestimmten Wertnamen abzurufen. |
|
Rufen Sie diese Methode auf, um die DWORD-Daten für einen angegebenen Wertnamen abzurufen. |
|
Rufen Sie diese Methode auf, um die GUIDdaten für einen angegebenen Wertnamen abzurufen. |
|
Rufen Sie diese Methode auf, um die Daten der mehrteiligen Zeichenfolge für einen angegebenen Wertnamen abzurufen. |
|
Rufen Sie diese Methode auf, um die QWORDdaten für einen angegebenen Wertnamen abzurufen. |
|
Rufen Sie diese Methode auf, um die Zeichenfolgendaten für einen angegebenen Wertnamen abzurufen. |
|
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. |
|
Rufen Sie diese Methode auf, um den angegebenen Schlüssel aus der Registrierung zu entfernen und alle Unterschlüssel explizit zu entfernen. |
|
Rufen Sie diese Methode auf, um den Binärwert des Registrierungsschlüssels festzulegen. |
|
Rufen Sie diese Methode auf, um den DWORD-Wert des Registrierungsschlüssels festzulegen. |
|
Rufen Sie diese Methode auf, um den GUID-Wert des Registrierungsschlüssels festzulegen. |
|
Rufen Sie diese Methode auf, um die Sicherheit des Registrierungsschlüssels festzulegen. |
|
Rufen Sie diese Methode auf, um Daten auf einem angegebenen Wertsgebiet eines angegebenen Schlüssels zu speichern. |
|
Rufen Sie diese Methode auf, um den Wert der mehrteiligen Zeichenfolge des Registrierungsschlüssels festzulegen. |
|
Rufen Sie diese Methode auf, um den QWORDwert des Registrierungsschlüssels festzulegen. |
|
Rufen Sie diese Methode auf, um den Zeichenfolgenwert des Registrierungsschlüssels festzulegen. |
|
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 |
|---|---|
Konvertiert ein Objekt CRegKey zu einem HKEY. |
|
Zuweisungsoperator |
Öffentliche Datenmember
Name |
Description |
|---|---|
Enthält ein Handle des Registrierungsschlüssels, der mit dem CRegKey-Objekt zugeordnet ist. |
|
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.
.gif "Sicherheitshinweis") 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