ORCreateHive function

Creates an offline registry hive that contains a single empty root key.

Syntax

DWORD ORCreateHive(
  _Out_ PORHKEY phkResult
);

Parameters

phkResult [out]

Points to a variable to receive a handle to the root key of the newly created offline registry hive. If the hive cannot be created, the function sets this parameter to NULL.

Return value

If the function succeeds, the return value is ERROR_SUCCESS.

If the function fails, the return value is a nonzero error code defined in Winerror.h. You can use the FormatMessage function with the FORMAT_MESSAGE_FROM_SYSTEM flag to get a generic description of the error.

If there is insufficient memory to create the registry hive, the function returns ERROR_NOT_ENOUGH_MEMORY.

Remarks

The ORCreateHive function creates an empty offline registry hive in memory. Use the ORCreateKey and ORSetValue functions to add keys and set their values.

Requirements

See also

ORCreateKey

OROpenHive

ORSaveHive

ORSetValue