AuditSetSecurity-Funktion (ntsecapi.h)
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 |
|---|---|
|
Der Aufrufer verfügt nicht über die Berechtigungen oder Zugriffsrechte, die zum Aufrufen dieser Funktion erforderlich sind. |
|
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 |