Función ORGetVirtualFlags

Recupera las marcas virtuales de la clave del Registro abierta especificada en un subárbol del Registro sin conexión.

Sintaxis

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

Parámetros

Identificador [in]

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

pdwFlags [out]

Puntero a una variable para recibir las marcas de virtualización establecidas para la clave. Una vez que se devuelve la función, este parámetro puede ser uno o varios de los valores siguientes.

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 que tiene la virtualización habilitada, el registro no intenta volver a abrir la clave. Si esta marca está desactivada, el Registro intenta volver a abrir la clave con MAXIMUM_ALLOWED acceso.
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

Requisito	Value
Redistribuible	Biblioteca del Registro sin conexión de Windows versión 1.0 o posterior
Encabezado	Offreg.h
Archivo DLL	Offreg.dll

Consulte también

ORSetVirtualFlags

Virtualización del registro