ORSaveHive-Funktion
Schreibt die angegebene Offlineregistrierungsstruktur in eine Datei.
Syntax
DWORD ORSaveHive(
_In_ ORHKEY Handle,
_In_ PCWSTR lpHivePath,
_In_ DWORD dwOsMajorVersion,
_In_ DWORD dwOsMinorVersion
);
Parameter
-
Handle [ In]
-
Ein Handle für die zu speichernde Offlineregistrierungsstruktur.
-
lpHivePath [ In]
-
Ein Zeiger auf eine Unicode-Zeichenfolge, die den Namen der Registrierungsstrukturdatei angibt. Dies darf nicht der Name einer vorhandenen Datei sein.
-
dwOsMajorVersion [ In]
-
Die Hauptversionsnummer des Betriebssystems. Dieser Member kann einer der folgenden Werte sein.
Wert Bedeutung - 5
Wenn dwOsMinorVersion 1 ist, wird das Windows XP verwendet.
Wenn dwOsMinorVersion 2 ist, ist das Betriebssystem Windows Server 2003 R2, Windows Server 2003 oder Windows XP Professional x64 Edition.- 6
Wenn dwOsMinorVersion 0 ist, wird das Betriebssystem Windows Server 2008 oder Windows Vista installiert.
Wenn dwOsMinorVersion 1 ist, wird das Windows Server 2008 R2 oder Windows 7 verwendet. -
dwOsMinorVersion [ In]
-
Die Nebenversionsnummer des Betriebssystems. Dieser Member kann einer der folgenden Werte sein.
Wert Bedeutung - 0
Wenn dwOsMajorVersion 6 ist, wird das Betriebssystem Windows Server 2008 oder Windows Vista installiert. - 1
Wenn dwOsMajorVersion 5 ist, wird das Betriebssystem Windows XP verwendet.
Wenn dwOsMajorVersion 6 ist, ist das Betriebssystem Windows Server 2008 R2 oder Windows 7.- 2
Wenn dwOsMajorVersion 5 ist, ist das Betriebssystem Windows Server 2003 R2, Windows Server 2003 oder Windows XP Professional x64 Edition.
Wenn dwOsMajorVersion 6 ist, muss der dwOsMinorVersion-Parameter 0 oder 1 sein.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ERROR _ SUCCESS.
Wenn die Funktion fehlschlägt, ist der Rückgabewert ein fehlerfreier Code, der in Winerror.h definiert ist. Sie können die FormatMessage-Funktion mit dem Flag FORMAT _ MESSAGE FROM SYSTEM _ _ verwenden, um eine generische Beschreibung des Fehlers zu erhalten. Mögliche Fehlercodes:
- Wenn der Aufrufer nicht über die erforderlichen Zugriffsrechte zum Schreiben der Datei verfügt, gibt die Funktion ERROR _ ACCESS _ DENIED zurück.
- Wenn die angegebene Datei bereits vorhanden ist, gibt die Funktion ERROR _ ALREADY _ EXISTS zurück.
Hinweise
Die ORSaveHive-Funktion muss verwendet werden, um Änderungen an einer Offlineregistrierungsstruktur zu speichern. Änderungen werden erst beibehalten, wenn ORSaveHive aufgerufen wird, um die Struktur in einer Datei zu speichern.
Die Parameter dwOsMajorVersion und dwOsMinorVersion geben zusammen das Zielformat der Registrierungsstrukturdatei an. In der folgenden Tabelle sind die neuesten Betriebssystemversionsnummern zusammengefasst.
| Betriebssystem | Versionsnummer |
|---|---|
| Windows Server 2008 R2 | 6.1 |
| Windows 7 | 6.1 |
| Windows Server 2008 | 6.0 |
| Windows Vista | 6.0 |
| Windows Server 2003 R2 | 5,2 |
| Windows Server 2003 | 5,2 |
| Windows XP Professional x64 Edition | 5,2 |
| Windows XP | 5,1 |
Verwenden Sie die GetVersionEx-Funktion, um Informationen zum aktuellen Betriebssystem abzurufen.
Die ORSaveHive-Funktion sperrt die Registrierungsstruktur, während sie die Struktur in die Datei schreibt, schließt dann die Datei und gibt die Sperre frei. Die Registrierungsstruktur verbleibt im Arbeitsspeicher, bis sie durch Aufrufen der ORCloseHive-Funktion geschlossen wird. Es ist möglich, weitere Änderungen an der Registrierungsstruktur vorzunehmen, während sie geöffnet ist. Um diese Änderungen zu erhalten, muss die Struktur jedoch in einer neuen Datei gespeichert werden, da die ORSaveHive-Funktion keine vorhandene Datei überschreibt.
Die ORSaveHive-Funktion kann verwendet werden, um einen Teil der Offlineregistrierungsstruktur zu speichern. Der im Handle-Parameter angegebene Schlüssel wird zum Stammschlüssel einer Struktur, die aus dem angegebenen Schlüssel und allen unteren Schlüsseln besteht.
Anforderungen
| Anforderung | Wert |
|---|---|
| Verteilbare Komponente |
Windows Offlineregistrierungsbibliothek, Version 1.0 oder höher |
| Header |
|
| DLL |
|