SECURITY_DESCRIPTOR-Struktur (winnt.h)

Artikel
03/04/2024

Die SECURITY_DESCRIPTOR-Struktur enthält die Sicherheitsinformationen, die einem -Objekt zugeordnet sind. Anwendungen verwenden diese Struktur, um die Sicherheits-status eines Objekts festzulegen und abzufragen.

Da das interne Format eines Sicherheitsdeskriptors variieren kann, wird empfohlen, dass Anwendungen die SECURITY_DESCRIPTOR Struktur nicht direkt ändern. Verwenden Sie zum Erstellen und Bearbeiten eines Sicherheitsdeskriptors die unter Siehe auch aufgeführten Funktionen.

Syntax

typedef struct _SECURITY_DESCRIPTOR {
  BYTE                        Revision;
  BYTE                        Sbz1;
  SECURITY_DESCRIPTOR_CONTROL Control;
  PSID                        Owner;
  PSID                        Group;
  PACL                        Sacl;
  PACL                        Dacl;
} SECURITY_DESCRIPTOR, *PISECURITY_DESCRIPTOR;

Member

Revision

Sbz1

Control

Owner

Group

Sacl

Dacl

Hinweise

Eine Sicherheitsbeschreibung enthält Informationen, die die folgenden Komponenten der Sicherheit eines Objekts angeben:

Eine Besitzersicherheits-ID (SID)
Eine primäre Gruppen-SID
Eine diskretionäre Zugriffssteuerungsliste (DACL)
Eine Systemzugriffssteuerungsliste (SACL)
Qualifizierer für die vorherigen Elemente

Mehrere Funktionen, die die SECURITY_DESCRIPTOR Struktur verwenden, erfordern, dass diese Struktur an einer gültigen Zeigergrenze im Arbeitsspeicher ausgerichtet ist. Diese Grenzen variieren je nach verwendetem Prozessortyp. Speicherbelegungsfunktionen wie malloc und LocalAlloc geben ordnungsgemäß ausgerichtete Zeiger zurück.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [Desktop-Apps \| UWP-Apps]
Kopfzeile	winnt.h (windows.h einschließen)