Función ORSetVirtualFlags

Establece marcas de virtualización en la clave del Registro abierta especificada en un subárbol del Registro sin conexión.

Sintaxis

DWORD ORSetVirtualFlags(
  _In_ ORHKEY Handle,
  _In_ DWORD  dwFlags
);

Parámetros

Identificador [in]

Identificador de una clave del Registro abierta en un subárbol del registro sin conexión.

dwFlags [in]

Este parámetro controla el comportamiento del Registro cuando se produce un error en una operación Create o Open en una clave de un subárbol virtualizado. Este parámetro puede ser uno o más de los siguientes valores.

Value	Significado
REG_KEY_DONT_SILENT_FAIL 4	Si se establece esta marca y se produce un error en una operación open en una clave para la que está habilitada la virtualización, el registro no intenta volver a abrir la clave. Si esta marca está desactivada, el Registro intenta volver a abrir la clave con el acceso MAXIMUM_ALLOWED.
REG_KEY_DONT_VIRTUALIZE 2	Si se establece esta marca y se produce un error en una operación de creación de clave porque el autor de la llamada no tiene el KEY_CREATE_SUB_KEY derecho en la clave primaria, el registro produce un error en la operación Crear. Si esta marca está desactivada, el Registro intenta crear la clave en el almacén virtual. El autor de la llamada debe tener la KEY_READ derecha en la clave primaria.
REG_KEY_RECURSE_FLAG 8	Si se establece esta marca, las marcas de virtualización del Registro se propagan desde la clave primaria. Si esta marca está clara, no se propagan las marcas de virtualización del Registro.

 

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es ERROR_SUCCESS.

Si la función no se ejecuta correctamente, el valor devuelto es un código de error distinto de cero definido en Winerror.h. Puede usar la función FormatMessage con la marca FORMAT_MESSAGE_FROM_SYSTEM para obtener una descripción genérica del error.

Observaciones

La virtualización del registro es una tecnología provisional de compatibilidad de aplicaciones que permite que las operaciones de escritura del Registro que tengan un impacto global se redirijan a ubicaciones por usuario. Este redireccionamiento es transparente para las aplicaciones que leen o escriben en el registro.

La virtualización del Registro se admite a partir de Windows Vista. Sin embargo, Microsoft pretende quitarlo de versiones futuras del sistema operativo Windows a medida que más aplicaciones son compatibles con Windows Vista. Por lo tanto, las aplicaciones no deben depender del comportamiento de la virtualización del registro en el sistema.

La virtualización del Registro solo está habilitada para lo siguiente:

• Procesos interactivos de 32 bits
• Claves en HKEY_LOCAL_MACHINE\Software
• Claves en las que un administrador puede escribir

Para obtener más información, consulte Virtualización del Registro.

Requisitos

Consulte también

ORGetVirtualFlags

Virtualización del registro