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 |
|
| Archivo DLL |
|
Consulte también