FONCTION ORSetVirtualFlags
Définit des indicateurs de virtualisation sur la clé de Registre ouverte spécifiée dans une ruche de Registre hors connexion.
Syntaxe
DWORD ORSetVirtualFlags(
_In_ ORHKEY Handle,
_In_ DWORD dwFlags
);
Paramètres
-
Handle [in]
-
Handle d’une clé de Registre ouverte dans une ruche de Registre hors connexion.
-
dwFlags [in]
-
Ce paramètre contrôle le comportement du Registre lorsqu’une opération Create ou Open échoue sur une clé dans une ruche virtualisée. Ce paramètre peut prendre une ou plusieurs des valeurs suivantes.
Valeur Signification - REG_KEY_DONT_SILENT_FAIL
- 4
Si cet indicateur est défini et qu’une opération Open échoue sur une clé pour laquelle la virtualisation est activée, le Registre ne tente pas de rouvrir la clé. Si cet indicateur est clair, le Registre tente de rouvrir la clé avec l’accès MAXIMUM_ALLOWED. - REG_KEY_DONT_VIRTUALIZE
- 2
Si cet indicateur est défini et qu’une opération Créer une clé échoue, car l’appelant n’a pas le KEY_CREATE_SUB_KEY droit sur la clé parente, le Registre échoue à l’opération Créer. Si cet indicateur est clair, le Registre tente de créer la clé dans le magasin virtuel. L’appelant doit avoir le KEY_READ droit sur la clé parente. - REG_KEY_RECURSE_FLAG
- 8
Si cet indicateur est défini, les indicateurs de virtualisation du Registre sont propagés à partir de la clé parente. Si cet indicateur est clair, les indicateurs de virtualisation du Registre ne sont pas propagés.
Valeur retournée
Si la fonction réussit, la valeur de retour est ERROR_SUCCESS.
Si la fonction échoue, la valeur de retour est un code d’erreur différent de zéro défini dans Winerror.h. Vous pouvez utiliser la fonction FormatMessage avec l’indicateur FORMAT_MESSAGE_FROM_SYSTEM pour obtenir une description générique de l’erreur.
Notes
La virtualisation de registre est une technologie de compatibilité des applications intermédiaire qui permet de rediriger les opérations d’écriture de registre ayant un impact global vers des emplacements par utilisateur. Cette redirection est transparente pour les applications qui lisent ou écrivent dans le Registre.
La virtualisation du Registre est prise en charge à partir de Windows Vista. Toutefois, Microsoft a l’intention de le supprimer des futures versions du système d’exploitation Windows, car d’autres applications sont compatibles avec Windows Vista. Par conséquent, les applications ne doivent pas dépendre du comportement de la virtualisation du Registre dans le système.
La virtualisation du Registre est activée uniquement pour les éléments suivants :
- Processus interactifs 32 bits
- Clés dans HKEY_LOCAL_MACHINE\Software
- Clés qu’un administrateur peut écrire
Pour plus d’informations, consultez Virtualisation du registre.
Spécifications
| Condition requise | Valeur |
|---|---|
| Composant redistribuable |
Bibliothèque du Registre windows hors connexion version 1.0 ou ultérieure |
| En-tête |
|
| DLL |
|
Voir aussi