Informationen zur Offlineregistrierungsbibliothek

Die Offline-Registrierungsbibliothek wird verwendet, um eine Registrierungsstruktur außerhalb der aktiven Systemregistrierung zu ändern.

Die Offline-Registrierungsbibliothek dient Szenarien für Registrierungsaktualisierungen, wie die Wartung eines Betriebssystemabbilds. Die Offlineregistrierungsfunktionen bieten die folgenden Funktionen, die mit den Standardregistrierungsfunktionen nicht verfügbar sind:

• Die Offline-Registrierungsfunktionen können verwendet werden, um einen Registrierungs-Hive in jedem unterstützten Registrierungsformat zu ändern. Die Standardregistrierungsfunktionen können nur Änderungen an einer aktiven Registrierungsstruktur vornehmen, und die Änderungen müssen mit der Version von Windows kompatibel sein, die auf dem System ausgeführt wird.
• Die Offlineregistrierungsbibliothek erfordert zum Öffnen einer Registrierungsstrukturdatei nur Lesezugriff und zum Speichern der Datei Schreibzugriff. Es werden keine anderen Zugriffsprüfungen für Objekte in der Struktur ausgeführt, sodass die Struktur mit Standardbenutzerberechtigungen geändert werden kann. Bei den Standardfunktionen der Registrierung ist das Laden eines Hives in die aktive Registrierung ein privilegierter Vorgang, der administrativen Zugriff erfordert.

Die Offlineregistrierungsfunktionen sollten aus folgenden Gründen nicht als Ersatz für die Systemregistrierungsfunktionen verwendet werden:

• Es ist nicht möglich, Registrierungsnester zwischen Prozessen unter Verwendung der Offline-Registrierungsfunktionen zu teilen.
• Die Offlineregistrierungsfunktionen verwenden einfache Sperrung, die zu einer schwerwiegenden Leistungsbeeinträchtigung für Multithread-Anwendungen führen kann.
• Änderungen, die mit den Offline-Registrierungsfunktionen vorgenommen wurden, werden erst gespeichert, wenn die ORSaveHive-Funktion aufgerufen wird.

Anwendungen sollten die Offlineregistrierungsfunktionen nicht verwenden, um die Sicherheitsanforderungen der Systemregistrierung zu umgehen. Zum Laden eines Hives kann eine Anwendung, die ohne die speziellen Berechtigungen der RegLoadKey--Funktion läuft, die RegLoadAppKey--Funktion verwenden.

Windows Server 2003 und Windows XP: Die RegLoadAppKey--Funktion wird nicht unterstützt.

Eine Offline-Registrierungsstruktur ist eine Registrierungsstruktur, die mithilfe der Offline-Registrierungsfunktionen in den Speicher geladen wurde. Um eine leere Offline-Registry-Hive zu erstellen, verwenden Sie die Funktion ORCreateHive. Um eine vorhandene Registrierungsstruktur zu ändern, verwenden Sie die RegSaveKey oder RegSaveKeyEx--Funktion, um eine Struktur aus der aktiven Systemregistrierung in einer Datei zu speichern, und verwenden Sie dann die OROpenHive--Funktion, um die Datei zu öffnen.

Die Funktionen ORCreateHive und OROpenHive geben einen Handle auf den Root-Schlüssel des Offline-Registrierungs-Hives zurück. Dieses Handle kann wie ein Handle für jeden anderen Schlüssel in der Offlineregistrierungsstruktur mit den folgenden Ausnahmen verwendet werden: Die ORCreateKey- und OROpenKey--Funktionen können nicht verwendet werden, um ein Handle an den Stammschlüssel zurückzugeben; die Funktion ORCloseKey- kann nicht zum Schließen des Stammschlüssels verwendet werden; und die Funktion ORDeleteKey- kann nicht zum Löschen des Stammschlüssels verwendet werden. In all diesen Fällen schlägt die Funktion mit ERROR_INVALID_PARAMETERfehl.

Verwenden Sie die Funktion ORCreateKey, um Schlüssel zu einer geöffneten Offline-Registry-Hive hinzuzufügen, und die Funktion ORSetValue, um die Werte der Schlüssel festzulegen. Die Offlineregistrierungsbibliothek unterstützt andere grundlegende Registrierungsvorgänge wie Aufzählen, Abrufen und Löschen von Schlüsseln und Werten sowie festlegen von Schlüsselattributen wie Sicherheit und Virtualisierungsverhalten. Eine Liste der Funktionen finden Sie unter Offline-Funktionen der Registry Library.

Um Änderungen an einem geöffneten Offline-Registrierungs-Hive zu speichern, verwenden Sie die Funktion ORSaveHive , um den Hive in einer Datei zu speichern. (Die Änderungen bleiben nur bestehen, wenn ORSaveHive aufgerufen wird.) Verwenden Sie nach dem Speichern der Struktur die ORCloseHive Funktion, um die Struktur zu schließen und ressourcen freizugeben, die ihr zugeordnet sind.

Ein Offline-Registrierungshive wird nur überprüft, wenn er mit der Funktion OROpenHive geöffnet wird. Wenn der Bienenstock beschädigt ist, schlägt der Vorgang einfach fehl; es wird kein Versuch unternommen, den Bienenstock zu reparieren. Zugriffsüberprüfungen auf Objekte im Hive werden erst durchgeführt, wenn der Hive mit der Funktion RegLoadKey in eine aktive Registrierung geladen wird.

Die Offlineregistrierungsfunktionen unterstützen die vordefinierten Schlüsselnicht.

Alle Schlüssel- und Wertnamenzeichenfolgen, die an Offlineregistrierungsfunktionen übergeben werden, müssen Unicode sein.

Verwandte Themen

Offline-Registrierungsbibliothekfunktionen