FUNZIONE ORCreateHive

Crea un hive del Registro di sistema offline che contiene una singola chiave radice vuota.

Sintassi

DWORD ORCreateHive(
  _Out_ PORHKEY phkResult
);

Parametri

phkResult [out]

Punta a una variabile per ricevere un handle alla chiave radice dell'hive del Registro di sistema offline appena creato. Se non è possibile creare l'hive, 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.

Se la memoria non è sufficiente per creare l'hive del Registro di sistema, la funzione restituisce ERROR_NOT_ENOUGH_MEMORY.

Commenti

La funzione ORCreateHive crea un hive del Registro di sistema offline vuoto in memoria. Usare le funzioni ORCreateKey e ORSetValue per aggiungere chiavi e impostarne i valori.

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

ORCreateKey

OROpenHive

ORSaveHive

ORSetValue