SeAppendPrivileges-Funktion (ntifs.h)

Artikel
02/07/2025

Die SeAppendPrivileges Routine fügt zusätzliche Berechtigungen an die Berechtigungen an, die in einer Zugriffsstatusstruktur festgelegt sind.

Syntax

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

Parameter

[in, out] AccessState

Zeiger auf eine vom Aufrufer zugewiesene ACCESS_STATE Struktur, die die aktuelle Zugriffsanforderung darstellt.

[in] Privileges

Zeiger auf eine vom Aufrufer zugewiesene PRIVILEGE_SET Struktur, die die hinzuzufügenden Berechtigungen enthält.

Rückgabewert

Rückgabecode	Beschreibung
STATUS_SUCCESS	Der Anfügevorgang war erfolgreich.
STATUS_INSUFFICIENT_RESOURCES	SeAppendPrivileges beim Zuordnen des Speichers für die neuen Berechtigungen ein Poolzuordnungsfehler aufgetreten ist.

Bemerkungen

Zunächst kann eine Zugriffsstatusstruktur bis zu drei Berechtigungen in seinem Berechtigungssatz enthalten. Wenn mehr als drei Berechtigungen gespeichert werden müssen, SeAppendPrivileges einen neuen Berechtigungssatz aus dem ausgelagerten Pool zuweist und sowohl die aktuellen Berechtigungen als auch die neuen Berechtigungen kopiert.

Weitere Informationen zur Sicherheits- und Zugriffssteuerung finden Sie unter Windows-Sicherheitsmodell für Treiberentwickler und die Dokumentation zu diesen Themen im Windows SDK.