Função ORGetVirtualFlags

Recupera os sinalizadores virtuais na chave do Registro aberta especificada em um hive de registro offline.

Sintaxe

DWORD ORGetVirtualFlags(
  _In_  ORHKEY Handle,
  _Out_ PDWORD pdwFlags
);

Parâmetros

Manipular [in]

Um identificador para uma chave do Registro aberta em um hive de registro offline.

pdwFlags [out]

Um ponteiro para uma variável para receber os sinalizadores de virtualização definidos para a chave. Depois que a função retorna, esse parâmetro pode ser um ou mais 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 que tenha a virtualização habilitada, o Registro não tentará reabrir a chave. Se esse sinalizador estiver claro, o Registro tentará reabrir a chave com 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

Confira também

ORSetVirtualFlags

Virtualização do Registro