Fonction SfcIsKeyProtected (sfc.h)

Article
08/26/2023

Détermine si la clé de Registre spécifiée est protégée. Les applications doivent éviter de remplacer les clés de Registre protégées.

Syntaxe

BOOL SfcIsKeyProtected(
  [in]           HKEY    KeyHandle,
  [in, optional] LPCWSTR SubKeyName,
  [in]           REGSAM  KeySam
);

Paramètres

[in] KeyHandle

Handle de la clé de Registre racine. Il doit s’agir d’un handle pour l’une des clés prédéfinies suivantes.

HKEY_CLASSES_ROOT

HKEY_CURRENT_USER

HKEY_LOCAL_MACHINE

HKEY_USERS

[in, optional] SubKeyName

Valeur de chaîne terminée par null contenant le nom de la sous-clé. Cette clé doit être une sous-clé de la clé identifiée par le paramètre hKey . Pour plus d’informations sur les noms de clés, consultez Structure du Registre. Si ce paramètre a la valeur NULL, la fonction vérifie uniquement si la clé de Registre racine est protégée.

[in] KeySam

Constante qui spécifie l’autre vue de Registre qui doit être utilisée par les applications qui s’exécutent sur Windows 64 bits. Cet indicateur est ignoré sur la plateforme x86. Pour plus d’informations, consultez Accès à un autre affichage du Registre.

Valeur	Signification
0x0000	Utilisez la clé de Registre 32 bits des applications 32 bits et la clé de Registre 64 bits des applications 64 bits.
KEY_WOW64_64KEY 0x0100	Utilisez la clé de Registre 64 bits d’une application 32 bits ou 64 bits.
KEY_WOW64_32KEY 0x0200	Utilisez la clé de Registre 32 bits d’une application 32 bits ou 64 bits.

Valeur retournée

Si la clé est protégée, la valeur de retour est une valeur différente de zéro.

Si la clé n’est pas protégée, la valeur de retour est zéro.

Remarques

Une clé est protégée par WRP si le chemin existe et est protégé par WRP. La fonction SfcIsKeyProtected indique qu’une sous-clé est protégée par WRP si la sous-clé a une clé parente protégée par WRP.

Par exemple, si la clé de Registre suivante existe sur le système et est protégée par WRP :

HKEY_LOCAL_MACHINE
   SOFTWARE
      Classes
         Microsoft
            <WinFeature>

La fonction SfcIsKeyProtected retourne une valeur différente de zéro pour la sous-clé suivante. La nouvelle sous-clé n’a pas besoin d’exister pour que la fonction détermine qu’elle est protégée par WRP.

HKEY_LOCAL_MACHINE
   SOFTWARE
      Classes
         Microsoft
            <WinFeature>
               <new subkey>

Configuration requise


Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	sfc.h
Bibliothèque	Sfc.lib
DLL	Sfc.dll

Voir aussi

SfcIsFileProtected

Partager via