GetSecurityDescriptorControl-Funktion (securitybaseapi.h)

Die GetSecurityDescriptorControl-Funktion ruft ein Sicherheitsdeskriptorsteuerelement und Revisionsinformationen ab.

Syntax

BOOL GetSecurityDescriptorControl(
  [in]  PSECURITY_DESCRIPTOR         pSecurityDescriptor,
  [out] PSECURITY_DESCRIPTOR_CONTROL pControl,
  [out] LPDWORD                      lpdwRevision
);

Parameter

[in] pSecurityDescriptor

Ein Zeiger auf eine SECURITY_DESCRIPTOR Struktur, deren Steuerungs- und Revisionsinformationen die Funktion abruft.

[out] pControl

Ein Zeiger auf eine SECURITY_DESCRIPTOR_CONTROL-Struktur , die die Steuerungsinformationen des Sicherheitsdeskriptors empfängt.

[out] lpdwRevision

Ein Zeiger auf eine Variable, die den Revisionswert des Sicherheitsdeskriptors empfängt. Dieser Wert wird immer festgelegt, auch wenn GetSecurityDescriptorControl einen Fehler zurückgibt.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Anforderungen

Anforderung Wert
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ßlich Windows.h)
Bibliothek Advapi32.lib
DLL Advapi32.dll

Weitere Informationen

Zugriffssteuerung Übersicht

Grundlegende Access Control-Funktionen

GetSecurityDescriptorDacl

GetSecurityDescriptorGroup

GetSecurityDescriptorLength

GetSecurityDescriptorOwner

GetSecurityDescriptorSacl

IsValidSecurityDescriptor

SECURITY_DESCRIPTOR

SECURITY_DESCRIPTOR_CONTROL