Função OROpenHive
Carrega o arquivo hive do registro especificado na memória e valida o hive.
Sintaxe
DWORD OROpenHive(
_In_ PCWSTR lpHivePath,
_Out_ PORHKEY phkResult
);
Parâmetros
-
lpHivePath [in]
-
Um ponteiro para uma cadeia de caracteres Unicode que especifica o nome do arquivo hive do Registro a ser carregado na memória. Esse pode ser um arquivo hive que foi salvo com a função ORSaveHive ou criado com a função RegSaveKey ou RegSaveKeyEx . O arquivo deve ter menos de 4 GB de tamanho e o chamador deve ter FILE_READ_DATA acesso ao arquivo. Para obter mais informações, consulte Segurança de arquivos e Direitos de Acesso.
-
phkResult [out]
-
Um ponteiro para uma variável que recebe um identificador para a chave raiz do hive do registro offline carregado. Se o arquivo hive do registro não puder ser aberto ou a validação falhar, 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. Os códigos de erro possíveis incluem o seguinte:
- Se o arquivo estiver vazio ou maior que 4 GB de tamanho, a função retornará ERROR_BADDB.
- Se o chamador não tiver os direitos de acesso necessários para abrir o arquivo, a função retornará ERROR_ACCESS_DENIED.
- Se o hive do registro falhar na validação, a função retornará ERROR_NOT_REGISTRY_FILE.
Comentários
A função OROpenHive é a única função de registro offline que valida um hive do Registro. Se a validação falhar, nenhuma tentativa será feita para reparar o hive.
Requisitos
| Requisito | Valor |
|---|---|
| Redistribuível |
Biblioteca do Registro Offline do Windows versão 1.0 ou posterior |
| Cabeçalho |
|
| DLL |
|
Confira também