AuditQuerySecurity-Funktion (ntsecapi.h)
Die AuditQuerySecurity-Funktion ruft einen Sicherheitsdeskriptor ab, der den Zugriff auf die Überwachungsrichtlinie delegiert.
Syntax
BOOLEAN AuditQuerySecurity(
[in] SECURITY_INFORMATION SecurityInformation,
[out] PSECURITY_DESCRIPTOR *ppSecurityDescriptor
);
Parameter
[in] SecurityInformation
Ein SECURITY_INFORMATION Wert, der angibt, welche Teile der Sicherheitsbeschreibung diese Funktion festlegt. Nur SACL_SECURITY_INFORMATION und DACL_SECURITY_INFORMATION werden 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.
[out] ppSecurityDescriptor
Die Adresse eines Zeigers auf eine wohlgeformte SECURITY_DESCRIPTOR Struktur, die den Zugriff auf das Überwachungssicherheitsobjekt steuert.
Rückgabewert
Wenn die Funktion erfolgreich ist, gibt sie TRUE zurück.
Wenn die Funktion fehlschlägt, gibt sie FALSE zurück. 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 |