Share via

AuditSetSecurity-Funktion (ntsecapi.h)

  • Artikel

Die AuditSetSecurity-Funktion legt einen Sicherheitsdeskriptor fest, der den Zugriff auf die Überwachungsrichtlinie delegiert.

Syntax

BOOLEAN AuditSetSecurity(
  [in] SECURITY_INFORMATION SecurityInformation,
  [in] PSECURITY_DESCRIPTOR pSecurityDescriptor
);

Parameter

[in] SecurityInformation

Ein SECURITY_INFORMATION Wert, der angibt, welche Teile des Sicherheitsdeskriptors diese Funktion festlegt. Es werden nur SACL_SECURITY_INFORMATION und DACL_SECURITY_INFORMATION unterstützt. Alle anderen Werte werden ignoriert. Wenn weder SACL_SECURITY_INFORMATION noch DACL_SECURITY_INFORMATION angegeben ist, schlägt diese Funktion fehl und gibt ERROR_INVALID_PARAMETER zurück.

[in] pSecurityDescriptor

Ein Zeiger auf eine wohlgeformte SECURITY_DESCRIPTOR Struktur, die den Zugriff auf das Überwachungssicherheitsobjekt steuert. Wenn dieser Parameter NULL ist, schlägt die Funktion fehl und gibt ERROR_INVALID_PARAMETER zurück.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird TRUE zurückgegeben.

Wenn die Funktion fehlschlägt, wird FALSE zurückgegeben. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf. GetLastError gibt möglicherweise einen der folgenden Fehlercodes zurück, die in WinError.h definiert sind.

Rückgabecode/-wert BESCHREIBUNG
ERROR_ACCESS_DENIED
5
 Der Aufrufer verfügt nicht über die Berechtigungen oder Zugriffsrechte, die zum Aufrufen dieser Funktion erforderlich sind.
ERROR_INVALID_PARAMETER
87
 Mindestens ein Parameter ist ungültig.

Hinweise

Um diese Funktion erfolgreich aufzurufen, muss der Aufrufer über SeSecurityPrivilege verfügen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile ntsecapi.h
Bibliothek Advapi32.lib
DLL Advapi32.dll

Weitere Informationen

AuditQuerySecurity