Informationen zur Offlineregistrierungsbibliothek

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

Die Offlineregistrierungsbibliothek ist für Registrierungsupdateszenarien wie die Wartung eines Betriebssystemimages vorgesehen. Die Offlineregistrierungsfunktionen bieten die folgenden Funktionen, die für die Standardregistrierungsfunktionen nicht verfügbar sind:

  • Die Offlineregistrierungsfunktionen können verwendet werden, um eine Registrierungsstruktur in einem beliebigen 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 werden.
  • Die Offlineregistrierungsbibliothek erfordert nur Lesezugriff, um eine Registrierungsstrukturdatei zu öffnen, und Schreibzugriff zum Speichern der Datei. Es werden keine weiteren Zugriffsüberprüfungen für Objekte in der Struktur ausgeführt, sodass die Struktur mit Standardbenutzerberechtigungen geändert werden kann. Mit den Standardregistrierungsfunktionen ist das Laden einer Struktur in die aktive Registrierung ein privilegierter Vorgang, der Administratorzugriff erfordert.

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

  • Es ist unmöglich, Registrierungsstrukturen mithilfe der Offlineregistrierungsfunktionen zwischen Prozessen gemeinsam zu nutzen.
  • Die Offlineregistrierungsfunktionen verwenden einfache Sperren, die zu schwerwiegenden Leistungseinbußen für Multithreadanwendungen führen können.
  • Änderungen an den Offlineregistrierungsfunktionen werden erst gespeichert, wenn die ORSaveHive-Funktion aufgerufen wird.

Anwendungen sollten die Offlineregistrierungsfunktionen nicht verwenden, um die Sicherheitsanforderungen der Systemregistrierung zu umgehen. Zum Laden einer Struktur kann eine Anwendung, die ohne die speziellen Berechtigungen ausgeführt wird, die für die RegLoadKey-Funktion erforderlich sind, die RegLoadAppKey-Funktion verwenden.

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

Eine Offlineregistrierungsstruktur ist eine Registrierungsstruktur, die mithilfe der Offlineregistrierungsfunktionen in den Arbeitsspeicher geladen wurde. Verwenden Sie die FUNKTION ORCreateHive, um eine leere Offlineregistrierungsstruktur zu erstellen. 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 ein Handle für den Stammschlüssel der Offlineregistrierungsstruktur zurück. Dieses Handle kann wie ein Handle für jeden anderen Schlüssel in der Offlineregistrierungsstruktur mit den folgenden Ausnahmen verwendet werden: Die Funktionen ORCreateKey und OROpenKey können nicht verwendet werden, um ein Handle an den Stammschlüssel zurückzugeben. Die ORCloseKey-Funktion kann nicht zum Schließen des Stammschlüssels verwendet werden. und die ORDeleteKey-Funktion kann nicht zum Löschen des Stammschlüssels verwendet werden. In all diesen Fällen schlägt die Funktion mit ERROR _ INVALID _ PARAMETER fehl.

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

Um Änderungen an einer geöffneten Offlineregistrierungsstruktur zu speichern, verwenden Sie die ORSaveHive-Funktion, um die Struktur 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 zugeordnete Ressourcen frei zu machen.

Eine Offlineregistrierungsstruktur wird nur überprüft, wenn sie mit der OROpenHive-Funktion geöffnet wird. Wenn die Struktur beschädigt ist, schlägt der Vorgang einfach fehl. es wird nicht versucht, die Struktur zu reparieren. Zugriffsüberprüfungen für Objekte in der Struktur werden erst ausgeführt, wenn die Struktur mit der RegLoadKey-Funktion in eine aktive Registrierung geladen wird.

Die Offlineregistrierungsfunktionen unterstützen die vordefinierten Schlüsselnicht.

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

Funktionen der _ Offlineregistrierungsbibliothek