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 |