FUNZIONE ORSaveHive

Scrive l'hive del Registro di sistema offline specificato in un file.

Sintassi

DWORD ORSaveHive(
  _In_ ORHKEY Handle,
  _In_ PCWSTR lpHivePath,
  _In_ DWORD  dwOsMajorVersion,
  _In_ DWORD  dwOsMinorVersion
);

Parametri

Handle [in]

Handle per l'hive del Registro di sistema offline da salvare.

lpHivePath [in]

Puntatore a una stringa Unicode che specifica il nome del file hive del Registro di sistema. Non può essere il nome di un file esistente.

dwOsMajorVersion [in]

Numero di versione principale del sistema operativo. Questo membro può essere uno dei valori seguenti.

Valore Significato
5
Se dwOsMinorVersion è 1, il sistema operativo è Windows XP.
Se dwOsMinorVersion è 2, il sistema operativo è Windows Server 2003 R2, Windows Server 2003 o Windows XP Professional x64 Edition.
6
Se dwOsMinorVersion è 0, il sistema operativo è Windows Server 2008 o Windows Vista.
Se dwOsMinorVersion è 1, il sistema operativo è Windows Server 2008 R2 o Windows 7.

 

dwOsMinorVersion [in]

Numero di versione secondaria del sistema operativo. Questo membro può essere uno dei valori seguenti.

Valore Significato
0
Se dwOsMajorVersion è 6, il sistema operativo è Windows Server 2008 o Windows Vista.
1
Se dwOsMajorVersion è 5, il sistema operativo è Windows XP.
Se dwOsMajorVersion è 6, il sistema operativo è Windows Server 2008 R2 o Windows 7.
2
Se dwOsMajorVersion è 5, il sistema operativo è Windows Server 2003 R2, Windows Server 2003 o Windows XP Professional x64 Edition.
Se dwOsMajorVersion è 6, il parametro dwOsMinorVersion deve essere 0 o 1.

 

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene ERROR_SUCCESS.

Se la funzione ha esito negativo, il valore restituito è un codice di errore diverso da zero definito in Winerror.h. È possibile usare la funzione FormatMessage con il flag FORMAT_MESSAGE_FROM_SYSTEM per ottenere una descrizione generica dell'errore. I codici di errore possibili includono quanto segue:

  • Se il chiamante non dispone dei diritti di accesso necessari per scrivere il file, la funzione restituisce ERROR_ACCESS_DENIED.
  • Se il file specificato esiste già, la funzione restituisce ERROR_ALREADY_EXISTS.

Commenti

La funzione ORSaveHive deve essere usata per salvare le modifiche apportate a un hive del Registro di sistema offline. Le modifiche non vengono mantenute finché non viene chiamato ORSaveHive per salvare l'hive in un file.

I parametri dwOsMajorVersion e dwOsMinorVersion specificano insieme il formato di destinazione del file hive del Registro di sistema. La tabella seguente riepiloga i numeri di versione più recenti del sistema operativo.

Sistema operativo Numero di versione
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

 

Usare la funzione GetVersionEx per recuperare informazioni sul sistema operativo corrente.

La funzione ORSaveHive blocca l'hive del Registro di sistema durante la scrittura dell'hive nel file, quindi chiude il file e rilascia il blocco. L'hive del Registro di sistema rimane in memoria finché non viene chiuso chiamando la funzione ORCloseHive . È possibile apportare ulteriori modifiche all'hive del Registro di sistema mentre è aperto; Tuttavia, per mantenere queste modifiche è necessario salvare l'hive in un nuovo file, perché la funzione ORSaveHive non sovrascriverà un file esistente.

La funzione ORSaveHive può essere usata per salvare parte dell'hive del Registro di sistema offline. La chiave specificata nel parametro Handle diventa la chiave radice di un hive costituito dalla chiave specificata e da tutte le relative sottochiavi.

Requisiti

Requisito Valore
Componente ridistribuibile
Libreria del Registro di sistema offline di Windows versione 1.0 o successiva
Intestazione
Offreg.h
DLL
Offreg.dll

Vedi anche

Getversionex

ORCloseHive

OROpenHive