Função ORCreateKey
Cria a chave do Registro especificada em um hive de registro offline. Se a chave já existir, a função a abrirá.
Sintaxe
DWORD ORCreateKey(
_In_ ORHKEY Handle,
_In_ PCWSTR lpSubKey,
_In_opt_ PWSTR lpClass,
_In_opt_ DWORD dwOptions,
_In_opt_ PSECURITY_DESCRIPTOR pSecurityDescriptor,
_Out_ PORHKEY phkResult,
_Out_opt_ PDWORD pdwDisposition
);
Parâmetros
-
Manipular [in]
-
Um identificador para uma chave do Registro aberta em um hive de registro offline.
-
lpSubKey [in]
-
Um ponteiro para uma cadeia de caracteres Unicode que contém o nome de uma subchave que essa função abre ou cria. O parâmetro lpSubKey deve especificar uma subchave da chave identificada pelo parâmetro Handle ; pode ter até 32 níveis de profundidade na árvore do Registro. Para obter mais informações sobre nomes de chave, consulte Estrutura do Registro.
Esse parâmetro não pode ser NULL.
Os nomes de chave não diferenciam maiúsculas de minúsculas.
-
lpClass [in, opcional]
-
A classe (tipo de objeto) dessa chave. Esse parâmetro pode ser ignorado. Este parâmetro pode ser NULL.
-
dwOptions [in, opcional]
-
Esse parâmetro pode ser 0 ou um dos valores a seguir.
Valor Significado - REG_OPTION_CREATE_LINK
- 0x00000002L
A chave é um link simbólico. O caminho de destino é atribuído ao valor L"SymbolicLinkValue" da chave. O caminho de destino deve ser um caminho absoluto do Registro. Se essa opção estiver definida, REG_OPTION_NON_VOLATILE também deverá ser definida.
Se o parâmetro lpSubKey especificar uma chave existente, ele deverá ter sido criado com REG_OPTION_CREATE_LINK.
Os links simbólicos do Registro devem ser usados somente quando absolutamente necessário para a compatibilidade do aplicativo.- REG_OPTION_NON_VOLATILE
- 0x00000000L
A chave não é volátil; esse é o padrão. As informações são armazenadas em um arquivo e preservadas quando o sistema é reiniciado. A função ORSaveHive salva chaves que não são voláteis. -
pSecurityDescriptor [in, opcional]
-
Um ponteiro para uma estrutura SECURITY_DESCRIPTOR que contém um descritor de segurança para a nova chave. Se pSecurityDescriptor for NULL, a chave obterá um descritor de segurança padrão. As ACLs em um descritor de segurança padrão para uma chave são herdadas de sua chave pai direta.
-
phkResult [out]
-
Um ponteiro para uma variável que recebe um identificador para a chave aberta ou criada. Use a função ORCloseKey para fechar a chave depois de terminar de usar o identificador.
-
pdwDisposition [out, opcional]
-
Um ponteiro para uma variável que recebe um dos seguintes valores de disposição.
Valor Significado - REG_CREATED_NEW_KEY
- 0x00000001L
A chave não existia e foi criada. - REG_OPENED_EXISTING_KEY
- 0x00000002L
A chave existia e foi simplesmente aberta sem ser alterada. Se pdwDisposition for NULL, nenhuma informação de disposição será retornada.
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 parâmetro dwOptions for definido com REG_OPTION_CREATE_LINK mas REG_OPTION_NON_VOLATILE estiver claro ou se o identificador a ser retornado for um identificador para a chave raiz do hive, a função retornará ERROR_INVALID_PARAMETER.
Comentários
A chave que a função ORCreateKey cria não tem valores. Um aplicativo pode usar a função ORSetValue para definir valores de chave.
A função ORCreateKey não pode ser usada para criar a chave raiz em um hive de registro offline. Use a função ORCreateHive para criar a chave raiz e obter um identificador para a chave.
O registro offline não dá suporte ao salvamento de chaves individuais. Use a função ORSaveHive para salvar uma chave e suas subchaves em um hive.
Requisitos
| Requisito | Valor |
|---|---|
| Redistribuível |
Biblioteca do Registro Offline do Windows versão 1.0 ou posterior |
| Cabeçalho |
|
| DLL |
|
Confira também