InitializeSecurityDescriptor-Funktion (securitybaseapi.h)

Artikel
08/25/2023

Die InitializeSecurityDescriptor-Funktion initialisiert einen neuen Sicherheitsdeskriptor.

Syntax

BOOL InitializeSecurityDescriptor(
  [out] PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [in]  DWORD                dwRevision
);

Parameter

[out] pSecurityDescriptor

Ein Zeiger auf eine SECURITY_DESCRIPTOR Struktur, die die Funktion initialisiert.

[in] dwRevision

Die Revisionsebene, die dem Sicherheitsdeskriptor zugewiesen werden soll. Dieser Parameter muss SECURITY_DESCRIPTOR_REVISION sein.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt die Funktion ungleich null zurück.

Wenn die Funktion fehlschlägt, wird null zurückgegeben. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Die InitializeSecurityDescriptor-Funktion initialisiert einen Sicherheitsdeskriptor im absoluten Format und nicht im selbstrelativen Format.

Die InitializeSecurityDescriptor-Funktion initialisiert einen Sicherheitsdeskriptor so, dass keine SACL (System Access Control List ), keine dacl (Discretionary Access Control List ), kein Besitzer, keine primäre Gruppe und alle Steuerelementflags auf FALSE (NULL) festgelegt sind. Daher ist es mit Ausnahme seiner Revisionsebene leer.

Beispiele

Ein Beispiel, das diese Funktion verwendet, finden Sie unter Erstellen eines Sicherheitsdeskriptors für ein neues Objekt.

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	securitybaseapi.h (Einschließen von Windows.h)
Bibliothek	Advapi32.lib
DLL	Advapi32.dll