SeAppendPrivileges-Funktion (ntifs.h)

Artikel
03/01/2024

Die SeAppendPrivileges-Routine fügt zusätzliche Berechtigungen an die in einer Zugriffsstatusstruktur festgelegten Berechtigungen an.

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 ist bei der Zuweisung von Arbeitsspeicher für die neuen Berechtigungen ein Poolzuordnungsfehler aufgetreten.

Hinweise

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

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