Freigeben über


InitializeSecurityDescriptor-Funktion (securitybaseapi.h)

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

Weitere Informationen

GetSecurityDescriptorControl

GetSecurityDescriptorDacl

GetSecurityDescriptorGroup

GetSecurityDescriptorLength

GetSecurityDescriptorOwner

GetSecurityDescriptorSacl

IsValidSecurityDescriptor

Low-Level-Access Control

Low-Level-Access Control Functions

SECURITY_DESCRIPTOR

SetSecurityDescriptorDacl

SetSecurityDescriptorGroup

SetSecurityDescriptorOwner

SetSecurityDescriptorSacl