Partager via


Fonction RegSetKeySecurity (winreg.h)

La fonction RegSetKeySecurity définit la sécurité d’une clé de Registre ouverte.

Syntaxe

LSTATUS RegSetKeySecurity(
  [in] HKEY                 hKey,
  [in] SECURITY_INFORMATION SecurityInformation,
  [in] PSECURITY_DESCRIPTOR pSecurityDescriptor
);

Paramètres

[in] hKey

Handle d’une clé ouverte pour laquelle le descripteur de sécurité est défini.

[in] SecurityInformation

Ensemble d’indicateurs de bits qui indiquent le type d’informations de sécurité à définir. Ce paramètre peut être une combinaison des indicateurs de bits SECURITY_INFORMATION .

[in] pSecurityDescriptor

Pointeur vers une structure de SECURITY_DESCRIPTOR qui spécifie les attributs de sécurité à définir pour la clé spécifiée.

Valeur retournée

Si la fonction réussit, la fonction retourne ERROR_SUCCESS.

Si la fonction échoue, elle retourne 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.

Remarques

Si hKey est l’une des clés prédéfinies, utilisez la fonction RegCloseKey pour fermer la clé prédéfinie afin de vous assurer que les nouvelles informations de sécurité sont en vigueur la prochaine fois que la clé prédéfinie est référencée.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête winreg.h (inclure Windows.h)
Bibliothèque Advapi32.lib
DLL Advapi32.dll

Voir aussi

FormatMessage

Access Control de bas niveau

Fonctions Access Control de bas niveau

RegCloseKey

RegDeleteKey

RegGetKeySecurity

SECURITY_DESCRIPTOR

SECURITY_INFORMATION