Función ORCreateHive

Crea un subárbol del Registro sin conexión que contiene una sola clave raíz vacía.

Sintaxis

DWORD ORCreateHive(
  _Out_ PORHKEY phkResult
);

Parámetros

phkResult [out]

Apunta a una variable para recibir un identificador de la clave raíz del subárbol del registro sin conexión recién creado. Si no se puede crear el subárbol, 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.

Si no hay memoria suficiente para crear el subárbol del Registro, la función devuelve ERROR_NOT_ENOUGH_MEMORY.

Observaciones

La función ORCreateHive crea un subárbol de registro sin conexión vacío en la memoria. Use las funciones ORCreateKey y ORSetValue para agregar claves y establecer sus valores.

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

ORCreateKey

OROpenHive

ORSaveHive

ORSetValue