Função ORSetVirtualFlags
Define sinalizadores de virtualização na chave do Registro aberta especificada em um hive de registro offline.
Sintaxe
DWORD ORSetVirtualFlags(
_In_ ORHKEY Handle,
_In_ DWORD dwFlags
);
Parâmetros
-
Manipular [in]
-
Um identificador para uma chave do Registro aberta em um hive de registro offline.
-
dwFlags [in]
-
Esse parâmetro controla o comportamento do registro quando uma operação Criar ou Abrir falha em uma chave em um hive virtualizado. Esse parâmetro pode usar um dos valores a seguir.
Valor Significado - REG_KEY_DONT_SILENT_FAIL
- 4
Se esse sinalizador estiver definido e uma operação Abrir falhar em uma chave para a qual a virtualização está habilitada, o Registro não tentará reabrir a chave. Se esse sinalizador estiver claro, o Registro tentará reabrir a chave com o acesso MAXIMUM_ALLOWED. - REG_KEY_DONT_VIRTUALIZE
- 2
Se esse sinalizador estiver definido e uma operação Criar Chave falhar porque o chamador não tiver o KEY_CREATE_SUB_KEY direito na chave pai, o registro falhará na operação Criar. Se esse sinalizador estiver claro, o Registro tentará criar a chave no repositório virtual. O chamador deve ter o KEY_READ diretamente na chave pai. - REG_KEY_RECURSE_FLAG
- 8
Se esse sinalizador for definido, os sinalizadores de virtualização do Registro serão propagados da chave pai. Se esse sinalizador estiver claro, os sinalizadores de virtualização do Registro não serão propagados.
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.
Comentários
A virtualização do Registro é uma tecnologia de compatibilidade de aplicativo provisória que permite que as operações de gravação do Registro que tenham impacto global sejam redirecionadas para locais por usuário. Esse redirecionamento é transparente para aplicativos que leem ou gravam no registro.
Há suporte para virtualização do Registro a partir do Windows Vista. No entanto, a Microsoft pretende removê-lo de versões futuras do sistema operacional Windows à medida que mais aplicativos forem compatíveis com o Windows Vista. Portanto, os aplicativos não devem depender do comportamento da virtualização do Registro no sistema.
A virtualização do Registro está habilitada apenas para o seguinte:
- Processos interativos de 32 bits
- Chaves em HKEY_LOCAL_MACHINE\Software
- Chaves nas quais um administrador pode gravar
Para obter mais informações, consulte Virtualização do Registro.
Requisitos
| Requisito | Valor |
|---|---|
| Redistribuível |
Biblioteca do Registro Offline do Windows versão 1.0 ou posterior |
| Cabeçalho |
|
| DLL |
|
Confira também