Fonction RegSetKeySecurity (winreg.h)

Article
03/04/2024

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