ORSetVirtualFlags fonction)
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
-
Gérer [ dans]
-
Handle d’une clé de Registre ouverte dans une ruche de Registre hors connexion.
-
dwFlags [ dans]
-
Ce paramètre contrôle le comportement du Registre lorsqu’une opération de création ou d’ouverture échoue sur une clé dans une ruche virtualisée. Ce paramètre peut être une ou plusieurs des valeurs suivantes.
Valeur Signification - Reg _ La clé ne dispose pas d’un _ _ _ échec silencieux
- 4
Si cet indicateur est défini et qu’une opération d’ouverture échoue sur une clé pour laquelle la virtualisation est activée, le registre n’essaie pas de rouvrir la clé. Si cet indicateur est désactivé, le registre tente de rouvrir la clé avec le MAXIMUM d' _ accès autorisé. - Reg _ CLÉ _ non _ virtualisée
- 2
Si cet indicateur est défini et qu’une opération de création de clé échoue parce que l’appelant n’a pas le _ droit créer une _ sous- _ clé de clé sur la clé parente, le registre fait échouer l’opération de création. Si cet indicateur est désactivé, le registre tente de créer la clé dans le magasin virtuel. L’appelant doit disposer de la clé _ Read Right sur la clé parente. - Reg _ _ _ Indicateur recurse de clé
- 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 désactivé, les indicateurs de virtualisation du registre ne sont pas propagés.
Valeur retournée
Si la fonction réussit, la valeur de retour est une erreur de _ réussite.
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 le format _ message _ de l' _ indicateur système pour obtenir une description générique de l’erreur.
Remarques
La virtualisation du Registre est une technologie de compatibilité des applications temporaire qui permet d’effectuer des opérations d’écriture dans le Registre qui ont un impact global sur les 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 envisage de la supprimer des versions futures du système d’exploitation Windows à mesure que 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 dans lesquelles un administrateur peut écrire
Pour plus d’informations, consultez virtualisation du Registre.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Composant redistribuable |
Windows Bibliothèque de Registre hors connexion version 1,0 ou ultérieure |
| En-tête |
|
| DLL |
|