FUNZIONE OROpenHive

  • Articolo

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
Offreg.h
DLL
Offreg.dll

Vedi anche

ORCloseHive

ORCreateHive

ORSaveHive

Regsavekey

RegSaveKeyEx