FONCTION ORGetVirtualFlags
Récupère les indicateurs virtuels sur la clé de Registre ouverte spécifiée dans une ruche de Registre hors connexion.
Syntaxe
DWORD ORGetVirtualFlags(
_In_ ORHKEY Handle,
_Out_ PDWORD pdwFlags
);
Paramètres
-
Gérer [in]
-
Handle d’une clé de Registre ouverte dans une ruche de Registre hors connexion.
-
pdwFlags [out]
-
Pointeur vers une variable pour recevoir les indicateurs de virtualisation définis pour la clé. Une fois la fonction retournée, ce paramètre peut être 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 d’ouverture é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 un 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 la KEY_READ droite 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 du Registre est une technologie de compatibilité d’application 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 versions futures du système d’exploitation Windows, car d’autres applications sont rendues 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 hors connexion Windows version 1.0 ou ultérieure |
| En-tête |
|
| DLL |
|
Voir aussi