Función OROpenHive

Carga el archivo de subárbol del Registro especificado en la memoria y valida el subárbol.

Sintaxis

DWORD OROpenHive(
  _In_  PCWSTR  lpHivePath,
  _Out_ PORHKEY phkResult
);

Parámetros

lpHivePath [in]

Puntero a una cadena Unicode que especifica el nombre del archivo de subárbol del Registro que se va a cargar en la memoria. Puede ser un archivo de hive que se guardó con la función ORSaveHive o creado con la función RegSaveKey o RegSaveKeyEx . El archivo debe tener menos de 4 GB de tamaño y el autor de la llamada debe tener FILE_READ_DATA acceso al archivo. Para obtener más información, vea Derechos de acceso y seguridad de archivos.

phkResult [out]

Puntero a una variable que recibe un identificador de la clave raíz del subárbol del registro sin conexión cargado. Si el archivo del subárbol del Registro no se puede abrir o se produce un error en la validación, la función establece este parámetro en NULL.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es ERROR_SUCCESS.

Si la función no se ejecuta correctamente, el valor devuelto es un código de error distinto de cero definido en Winerror.h. Puede usar la función FormatMessage con la marca FORMAT_MESSAGE_FROM_SYSTEM para obtener una descripción genérica del error. Entre los posibles códigos de error se incluyen los siguientes:

• Si el archivo está vacío o tiene más de 4 GB de tamaño, la función devuelve ERROR_BADDB.
• Si el autor de la llamada no tiene los derechos de acceso necesarios para abrir el archivo, la función devuelve ERROR_ACCESS_DENIED.
• Si se produce un error en la validación del subárbol del Registro, la función devuelve ERROR_NOT_REGISTRY_FILE.

Observaciones

La función OROpenHive es la única función del Registro sin conexión que valida un subárbol del Registro. Si se produce un error en la validación, no se intenta reparar el subárbol.

Requisitos

Requisito	Value
Redistribuible	Biblioteca del Registro sin conexión de Windows versión 1.0 o posterior
Encabezado	Offreg.h
Archivo DLL	Offreg.dll

Consulte también

ORCloseHive

ORCreateHive

ORSaveHive

RegSaveKey

RegSaveKeyEx