SeAppendPrivileges, fonction (ntifs.h)

Article
02/07/2025

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 ACCESS_STATE allouée par l’appelant représentant la demande d’accès actuelle.

[in] Privileges

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

Valeur de retour

Retourner le code	Description
STATUS_SUCCESS	L’opération d’ajout a réussi.
STATUS_INSUFFICIENT_RESOURCES	SeAppendPrivileges 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 jeu 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 copie dans celui-ci 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.