Informazioni sulla libreria del Registro offline

La libreria del Registro di sistema offline viene usata per modificare un hive del Registro di sistema all'esterno del registro di sistema attivo.

La libreria del Registro di sistema offline è destinata a scenari di aggiornamento del Registro di sistema, ad esempio la manutenzione di un'immagine del sistema operativo. Le funzioni del Registro di sistema offline offrono le funzionalità seguenti che non sono disponibili con le funzioni del Registro di sistema standard:

• Le funzioni del Registro di sistema offline possono essere usate per modificare un hive del Registro di sistema in qualsiasi formato del Registro di sistema supportato. Le funzioni del Registro di sistema standard possono apportare modifiche solo a un hive del Registro di sistema attivo e le modifiche devono essere compatibili con la versione di Windows in esecuzione nel sistema.
• La libreria del Registro di sistema offline richiede solo l'accesso in lettura per aprire un file Hive del Registro di sistema e l'accesso in scrittura per salvare il file. Non vengono eseguiti altri controlli di accesso sugli oggetti nell'hive, rendendo possibile modificare l'hive con privilegi utente standard. Con le funzioni del Registro di sistema standard, il caricamento di un hive nel Registro di sistema attivo è un'operazione con privilegi che richiede l'accesso amministrativo.

Le funzioni del Registro di sistema offline non devono essere usate come sostituto delle funzioni del Registro di sistema per i motivi seguenti:

• Non è possibile condividere hive del Registro di sistema tra processi usando le funzioni del Registro di sistema offline.
• Le funzioni del Registro di sistema offline usano un semplice blocco che può comportare una grave riduzione delle prestazioni per le applicazioni multithreading.
• Le modifiche apportate con le funzioni del Registro di sistema offline non vengono salvate finché non viene chiamata la funzione ORSaveHive.

Le applicazioni non devono usare le funzioni del Registro di sistema offline per ignorare i requisiti di sicurezza del Registro di sistema. Per caricare un hive, un'applicazione in esecuzione senza i privilegi speciali richiesti dalla funzione RegLoadKey può usare la funzione RegLoadAppKey.

Windows Server 2003 e Windows XP: La funzione RegLoadAppKey non è supportata.

Un hive del Registro di sistema offline è un hive del Registro di sistema caricato in memoria usando le funzioni del Registro di sistema offline. Per creare un hive del Registro di sistema offline vuoto, usare la funzione ORCreateHive. Per modificare un hive del Registro di sistema esistente, usare la funzione RegSaveKey o regSaveKeyEx per salvare un hive dal Registro di sistema attivo in un file e quindi usare la funzione OROpenHive per aprire il file.

Le funzioni ORCreateHive e OROpenHive restituiscono un handle alla chiave radice dell'hive del Registro di sistema offline. Questo handle può essere usato come handle per qualsiasi altra chiave nell'hive del Registro di sistema offline con le eccezioni seguenti: le funzioni ORCreateKey e OROpenKey non possono essere usate per restituire un handle alla chiave radice; la funzioneORCloseKeynon può essere usata per chiudere la chiave radice; e la funzioneORDeleteKeynon può essere usata per eliminare la chiave radice. In tutti questi casi, la funzione ha esito negativo con ERROR_INVALID_PARAMETER.

Usare la funzione ORCreateKey per aggiungere chiavi a un hive del Registro di sistema offline aperto e la funzione ORSetValue per impostare i valori delle chiavi. La libreria del Registro di sistema offline supporta altre operazioni di base del Registro di sistema, ad esempio l'enumerazione, il recupero e l'eliminazione di chiavi e valori e l'impostazione di attributi chiave, ad esempio il comportamento di sicurezza e virtualizzazione. Per un elenco delle funzioni, vedere Funzioni della libreria del Registro di sistema offline.

Per salvare le modifiche apportate a un hive del Registro di sistema offline aperto, usare la funzione ORSaveHive per salvare l'hive in un file. Le modifiche non vengono mantenute a meno che non venga chiamato ORSaveHive. Dopo aver salvato l'hive, usare la funzione ORCloseHive per chiudere l'hive e liberare le risorse associate.

Un hive del Registro di sistema offline viene convalidato solo quando viene aperto utilizzando la funzione OROpenHive . Se l'hive è danneggiato, l'operazione ha semplicemente esito negativo; non viene effettuato alcun tentativo di riparare l'hive. I controlli di accesso sugli oggetti nell'hive non vengono eseguiti finché l'hive non viene caricato in un registro attivo con la funzione RegLoadKey.

Le funzioni del Registro di sistema offline non supportano le chiavi predefinite .

Tutte le stringhe chiave e nome valore passate alle funzioni del Registro di sistema offline devono essere Unicode.

Argomenti correlati

Library_Funzioni del Registro Offline