Fonction SeAppendPrivileges (ntifs.h)

Article
02/29/2024

La routine SeAppendPrivileges ajoute des privilèges supplémentaires au jeu de privilèges dans une structure d’état d’accès.

Syntaxe

NTSTATUS SeAppendPrivileges(
  [in, out] PACCESS_STATE  AccessState,
  [in]      PPRIVILEGE_SET Privileges
);

Paramètres

[in, out] AccessState

Pointeur vers une structure de ACCESS_STATE allouée à l’appelant représentant la demande d’accès actuelle.

[in] Privileges

Pointeur vers une structure de PRIVILEGE_SET allouée à l’appelant contenant les privilèges à ajouter.

Valeur retournée

Code de retour	Description
STATUS_SUCCESS	L’opération d’ajout a réussi.
STATUS_INSUFFICIENT_RESOURCES	SeAppendPrivileges a rencontré un échec d’allocation de pool lors de l’allocation de mémoire pour les nouveaux privilèges.

Remarques

Initialement, une structure d’état d’accès peut contenir jusqu’à trois privilèges dans son ensemble de privilèges. Si plus de trois privilèges doivent être stockés, SeAppendPrivileges alloue un nouveau jeu de privilèges à partir du pool paginé et y copie les privilèges actuels et les nouveaux privilèges.

Pour plus d’informations sur la sécurité et le contrôle d’accès, consultez Modèle de sécurité Windows pour les développeurs de pilotes et la documentation sur ces rubriques dans le Kit de développement logiciel (SDK) Windows.