Função ORCreateHive

Cria um hive de registro offline que contém uma única chave raiz vazia.

Sintaxe

DWORD ORCreateHive(
  _Out_ PORHKEY phkResult
);

Parâmetros

phkResult [out]

Aponta para uma variável para receber um identificador para a chave raiz do hive do registro offline recém-criado. Se o hive não puder ser criado, a função definirá esse parâmetro como NULL.

Valor retornado

Se a função obtiver êxito, o valor retornado será ERROR_SUCCESS.

Se a função falhar, o valor de retorno será o código de erro diferente de zero definido em Winerror.h. Você pode usar a função FormatMessage com o sinalizador FORMAT_MESSAGE_FROM_SYSTEM para obter uma descrição genérica do erro.

Se não houver memória suficiente para criar o hive do Registro, a função retornará ERROR_NOT_ENOUGH_MEMORY.

Comentários

A função ORCreateHive cria um hive de registro offline vazio na memória. Use as funções ORCreateKey e ORSetValue para adicionar chaves e definir seus valores.

Requisitos

Requisito	Valor
Redistribuível	Biblioteca do Registro Offline do Windows versão 1.0 ou posterior
Cabeçalho	Offreg.h
DLL	Offreg.dll

Confira também

ORCreateKey

OROpenHive

ORSaveHive

ORSetValue