Função OROpenKey
Abre a chave do Registro especificada em um hive de registro offline.
Sintaxe
DWORD OROpenKey(
_In_ ORHKEY Handle,
_In_opt_ PCWSTR lpSubKeyName,
_Out_ PORHKEY phkResult
);
Parâmetros
-
Manipular [in]
-
Um identificador para uma chave do Registro aberta em um hive de registro offline.
-
lpSubKeyName [in, opcional]
-
Um ponteiro para uma cadeia de caracteres UNICODE que contém o nome da chave do Registro a ser aberta. Essa chave deve ser uma subchave da chave identificada pelo parâmetro Handle .
Os nomes de chave não diferenciam maiúsculas de minúsculas.
Se esse parâmetro for NULL ou um ponteiro para uma cadeia de caracteres vazia, a função retornará o mesmo identificador que foi passado. Se a chave especificada pelo parâmetro Handle for a chave raiz do hive, a função retornará ERROR_INVALID_PARAMETER.
Para obter mais informações, consulte Limites de tamanho do elemento do Registro.
-
phkResult [out]
-
Um ponteiro para uma variável que recebe um identificador para a chave aberta. Use a função ORCloseKey para fechar a chave depois de terminar de usar o identificador.
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 o identificador a ser retornado for um identificador para a chave raiz do hive, a função retornará ERROR_INVALID_PARAMETER.
Se a chave especificada tiver sido marcada como excluída, essa função retornará ERROR_KEY_DELETED.
Comentários
A função OROpenKey não pode ser usada para abrir a chave raiz em um hive de registro offline. Para obter um identificador para a chave raiz de um hive, use a função OROpenHive para carregar o hive na memória.
Requisitos
| Requisito | Valor |
|---|---|
| Redistribuível |
Biblioteca do Registro Offline do Windows versão 1.0 ou posterior |
| Cabeçalho |
|
| DLL |
|
Confira também