FUNZIONE OROpenHive
Carica il file hive del Registro di sistema specificato in memoria e convalida l'hive.
Sintassi
DWORD OROpenHive(
_In_ PCWSTR lpHivePath,
_Out_ PORHKEY phkResult
);
Parametri
-
lpHivePath [in]
-
Puntatore a una stringa Unicode che specifica il nome del file hive del Registro di sistema da caricare in memoria. Può trattarsi di un file hive salvato con la funzione ORSaveHive o creato con la funzione RegSaveKey o RegSaveKeyEx . Il file deve avere dimensioni inferiori a 4 GB e il chiamante deve avere FILE_READ_DATA accesso al file. Per altre informazioni, vedere Protezione dei file e diritti di accesso.
-
phkResult [out]
-
Puntatore a una variabile che riceve un handle per la chiave radice dell'hive del Registro di sistema offline caricato. Se il file Hive del Registro di sistema non può essere aperto o la convalida ha esito negativo, la funzione imposta questo parametro su NULL.
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 file è vuoto o maggiore di 4 GB di dimensioni, la funzione restituisce ERROR_BADDB.
- Se il chiamante non dispone dei diritti di accesso necessari per aprire il file, la funzione restituisce ERROR_ACCESS_DENIED.
- Se la convalida dell'hive del Registro di sistema non riesce, la funzione restituisce ERROR_NOT_REGISTRY_FILE.
Commenti
La funzione OROpenHive è l'unica funzione del Registro di sistema offline che convalida un hive del Registro di sistema. Se la convalida non riesce, non viene effettuato alcun tentativo di ripristino dell'hive.
Requisiti
| Requisito | Valore |
|---|---|
| Componente ridistribuibile |
Libreria del Registro di sistema offline di Windows versione 1.0 o successiva |
| Intestazione |
|
| DLL |
|
Vedi anche