Fonction SfcIsKeyProtected (sfc.h)

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 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

Voir aussi

SfcIsFileProtected