Funzione ORGetVirtualFlags
Recupera i flag virtuali nella chiave del Registro di sistema aperta specificata in un hive del Registro di sistema offline.
Sintassi
DWORD ORGetVirtualFlags(
_In_ ORHKEY Handle,
_Out_ PDWORD pdwFlags
);
Parametri
-
Handle [in]
-
Handle per una chiave del Registro di sistema aperta in un hive del Registro di sistema offline.
-
pdwFlags [out]
-
Puntatore a una variabile per ricevere i flag di virtualizzazione impostati per la chiave. Al termine della funzione, questo parametro può essere uno o più dei valori seguenti.
Valore Significato - REG_KEY_DONT_SILENT_FAIL
- 4
Se questo flag è impostato e un'operazione Di apertura non riesce su una chiave con virtualizzazione abilitata, il Registro di sistema non tenta di riaprire la chiave. Se questo flag è chiaro, il Registro di sistema tenta di riaprire la chiave con accesso MAXIMUM_ALLOWED. - REG_KEY_DONT_VIRTUALIZE
- 2
Se questo flag è impostato e un'operazione Crea chiave ha esito negativo perché il chiamante non dispone del KEY_CREATE_SUB_KEY diritto sulla chiave padre, il Registro di sistema non riesce l'operazione Crea. Se questo flag è chiaro, il Registro di sistema tenta di creare la chiave nell'archivio virtuale. Il chiamante deve avere la KEY_READ destra sulla chiave padre. - REG_KEY_RECURSE_FLAG
- 8
Se questo flag è impostato, i flag di virtualizzazione del Registro di sistema vengono propagati dalla chiave padre. Se questo flag è chiaro, i flag di virtualizzazione del Registro di sistema non vengono propagati.
Valore restituito
Se la funzione ha esito positivo, il valore restituito viene ERROR_SUCCESS.
Se la funzione ha esito negativo, il valore restituito è un codice di errore diverso da zero definito in Winerror.h. È possibile usare la funzione FormatMessage con il flag FORMAT_MESSAGE_FROM_SYSTEM per ottenere una descrizione generica dell'errore.
Commenti
La virtualizzazione del Registro di sistema è una tecnologia provvisoria di compatibilità delle applicazioni che consente di reindirizzare le operazioni di scrittura del Registro di sistema con impatto globale alle posizioni per utente. Questo reindirizzamento è trasparente alle applicazioni che leggono o scrivono nel Registro di sistema.
La virtualizzazione del Registro di sistema è supportata a partire da Windows Vista. Tuttavia, Microsoft intende rimuoverlo dalle versioni future del sistema operativo Windows perché più applicazioni sono rese compatibili con Windows Vista. Pertanto, le applicazioni non devono dipendere dal comportamento della virtualizzazione del Registro di sistema nel sistema.
La virtualizzazione del Registro di sistema è abilitata solo per gli elementi seguenti:
- Processi interattivi a 32 bit
- Chiavi in HKEY_LOCAL_MACHINE\Software
- Chiavi in cui un amministratore può scrivere
Per altre informazioni, vedere Virtualizzazione del Registro di sistema.
Requisiti
| Requisito | Valore |
|---|---|
| Componente ridistribuibile |
Libreria del Registro di sistema offline di Windows versione 1.0 o successiva |
| Intestazione |
|
| DLL |
|
Vedi anche