TreeResetNamedSecurityInfoW, fonction (aclapi.h)
La fonction TreeResetNamedSecurityInfo réinitialise les informations de sécurité spécifiées dans le descripteur de sécurité d’une arborescence d’objets spécifiée. Cette fonction permet à une liste de contrôle d’accès discrétionnaire (DACL) ou à tous les éléments de la liste de contrôle d’accès système (SACL) d’être propagées dans toute une arborescence. Cette fonction prend en charge une fonction de rappel pour suivre la progression de l’opération d’arborescence.
Syntaxe
DWORD TreeResetNamedSecurityInfoW(
[in] LPWSTR pObjectName,
[in] SE_OBJECT_TYPE ObjectType,
[in] SECURITY_INFORMATION SecurityInfo,
[in, optional] PSID pOwner,
[in, optional] PSID pGroup,
[in, optional] PACL pDacl,
[in, optional] PACL pSacl,
[in] BOOL KeepExplicit,
[in, optional] FN_PROGRESS fnProgress,
[in] PROG_INVOKE_SETTING ProgressInvokeSetting,
[in, optional] PVOID Args
);
Paramètres
[in] pObjectName
Pointeur vers
[in] ObjectType
Valeur de l’énumération SE_OBJECT_TYPE qui indique le type d’objet nommé par le paramètre pObjectName. Les valeurs prises en charge sont SE_REGISTRY_KEY et SE_FILE_OBJECT, respectivement pour les clés de Registre et les objets de fichier.
[in] SecurityInfo
Ensemble d’indicateurs de bits qui indiquent le type d’informations de sécurité à réinitialiser. Ce paramètre peut être une combinaison des indicateurs de bits SECURITY_INFORMATION.
[in, optional] pOwner
Pointeur vers une structure SID qui identifie le propriétaire de l’objet. Le SID doit être celui qui peut être attribué en tant que SID propriétaire d’un descripteur de sécurité. Le paramètre SecurityInfo doit inclure l’indicateur de OWNER_SECURITY_INFORMATION. Pour définir le propriétaire, l’appelant doit avoir WRITE_OWNER accès à chaque objet, y compris l’objet racine. Si vous ne définissez pas le SID propriétaire, ce paramètre peut être NULL.
[in, optional] pGroup
Pointeur vers une structure SID qui identifie le groupe principal de l’objet. Le paramètre SecurityInfo doit inclure l’indicateur de GROUP_SECURITY_INFORMATION. Pour définir le groupe, l’appelant doit avoir WRITE_OWNER accès à chaque objet, y compris l’objet racine. Si vous ne définissez pas le SID du groupe principal, ce paramètre peut être NULL.
[in, optional] pDacl
Pointeur vers une structure de liste de contrôle d’accès (ACL) qui représente la nouvelle liste DACL pour les objets réinitialisés. Le paramètre SecurityInfo doit inclure l’indicateur de DACL_SECURITY_INFORMATION. L’appelant doit avoir READ_CONTROL et WRITE_DAC accès à chaque objet, y compris l’objet racine. Si vous ne définissez pas daCL, ce paramètre peut être NULL.
[in, optional] pSacl
Pointeur vers une structure de liste de contrôle d’accès qui représente la nouvelle liste DE contrôle d’accès pour les objets réinitialisés. Le paramètre SecurityInfo doit inclure l’un des indicateurs suivants : SACL_SECURITY_INFORMATION, LABEL_SECURITY_INFORMATION, ATTRIBUTE_SECURITY_INFORMATION, SCOPE_SECURITY_INFORMATION ou BACKUP_SECURITY_INFORMATION. Si vous définissez SACL_SECURITY_INFORMATION ou SCOPE_SECURITY_INFORMATION, l’appelant doit activer le privilège SE_SECURITY_NAME. Si vous ne définissez pas la liste de contrôle d’accès partagé, ce paramètre peut être NULL.
[in] KeepExplicit
Valeur booléenne qui définit si les AE définies explicitement sont conservées ou supprimées pour la sous-arborescence. Si KeepExplicit est TRUE, les AE définies explicitement sont conservées pour chaque daCL et saCL de sous-arborescence, et les ACL héritées sont remplacées par les ACL héritées de pDacl et pSacl. Si KeepExplicit est FALSE, les ACL définies explicitement pour chaque daCL et saCL sous-arborescence sont supprimées avant que les AE héritées ne soient remplacées par les ACL héritées de pDacl et pSacl.
[in, optional] fnProgress
Pointeur vers la fonction utilisée pour suivre la progression de la fonction TreeResetNamedSecurityInfo. Le prototype de la fonction de progression est le suivant :
#include <windows.h>
#include <Aclapi.h>
typedef VOID (*FN_PROGRESS) (
IN LPWSTR pObjectName, // Name of object just processed
IN DWORD Status, // Status of operation on object
IN OUT PPROG_INVOKE_SETTING pInvokeSetting, // When to set
IN PVOID Args, // Caller specific data
IN BOOL SecuritySet // Whether security was set
);
La fonction de progression fournit à l’appelant des informations de progression et d’erreur lorsque les nœuds sont traités. L’appelant spécifie la fonction de progression dans fnProgress, et pendant l’opération d’arborescence, TreeResetNamedSecurityInfo passe le nom du dernier objet traité, l’état d’erreur de cette opération et la valeur PROG_INVOKE_SETTING actuelle. L’appelant peut modifier la valeur de PROG_INVOKE_SETTING à l’aide de pInvokeSetting.
Si aucune fonction de progression n’est à utiliser, définissez ce paramètre sur NULL.
[in] ProgressInvokeSetting
Valeur de l’énumération PROG_INVOKE_SETTING qui spécifie le paramètre initial de la fonction de progression.
[in, optional] Args
Pointeur vers un VOID pour les arguments de fonction de progression spécifiés par l’appelant.
Valeur de retour
Si la fonction réussit, la fonction retourne ERROR_SUCCESS.
Si la fonction échoue, elle retourne un code d’erreur défini dans WinError.h.
Remarques
La définition d’une NULL propriétaire, groupe, DACL ou SACL n’est pas prise en charge par cette fonction.
Si l’appelant ne contient pas les privilèges et autorisations appropriés pour prendre en charge les mises à jour propriétaire, groupe, DACL et SACL demandées, aucune des mises à jour n’est effectuée.
Cette fonction est similaire à la fonction TreeSetNamedSecurityInfo :
- Si le paramètre KeepExplicit de TreeResetNamedSecurityInfo est défini sur TRUE, la fonction équivaut à TreeSetNamedSecurityInfo avec le paramètre dwAction défini sur TREE_SEC_INFO_RESET_KEEP_EXPLICIT.
- Si le paramètre KeepExplicit de TreeResetNamedSecurityInfo est défini sur FALSE, la fonction équivaut à TreeSetNamedSecurityInfo avec le paramètre dwAction défini sur TREE_SEC_INFO_RESET.
Note
L’en-tête aclapi.h définit TreeResetNamedSecurityInfo comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows XP [applications de bureau uniquement] |
| serveur minimum pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| plateforme cible | Windows |
| d’en-tête | aclapi.h |
| bibliothèque | Advapi32.lib |
| DLL | Advapi32.dll |