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 kann 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, ist das Betriebssystem Windows XP. 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, ist das Betriebssystem Windows Server 2008 oder Windows Vista. Wenn dwOsMinorVersion 1 ist, ist das Betriebssystem Windows Server 2008 R2 oder Windows 7.

 

dwOsMinorVersion [in]

Die Nebenversionsnummer des Betriebssystems. Dieser Member kann einer der folgenden Werte sein.

Wert	Bedeutung
0	Wenn dwOsMajorVersion 6 ist, ist das Betriebssystem Windows Server 2008 oder Windows Vista.
1	Wenn dwOsMajorVersion 5 ist, ist das Betriebssystem Windows XP. 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, wird der Rückgabewert ERROR_SUCCESS.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein nichtzero-Fehlercode, 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 abzurufen. Mögliche Fehlercodes sind:

• 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.

Bemerkungen

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 Versionsnummern des Betriebssystems zusammengefasst.

Betriebssystem	Versionsnummer
Windows Server 2008 R2	6.1
Windows 7	6.1
WindowsServer 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 auf. 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 beizubehalten, muss die Struktur jedoch in einer neuen Datei gespeichert werden, da die ORSaveHive-Funktion eine vorhandene Datei nicht ü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 zugehörigen Unterschlüsseln besteht.

Anforderungen

Anforderung	Wert
Verteilbare Komponente	Windows-Offlineregistrierungsbibliothek Version 1.0 oder höher
Header	Offreg.h
DLL	Offreg.dll

Siehe auch

Getversionex

ORCloseHive

OROpenHive