AuditQueryGlobalSaclA-Funktion (ntsecapi.h)

Die AuditQueryGlobalSacl-Funktion ruft eine globale Systemzugriffssteuerungsliste (SACL) ab, die den Zugriff auf die Überwachungsmeldungen delegiert. Das Aktualisieren der globalen SACL erfordert die SeSecurityPrivilege-, die die globale SACL vor der Aktualisierung durch jeden Benutzer ohne Administratorrechte schützt.

Syntax

BOOLEAN AuditQueryGlobalSaclA(
  [in]  PCSTR ObjectTypeName,
  [out] PACL  *Acl
);

Parameter

[in] ObjectTypeName

Ein Zeiger auf eine mit Null beendete Zeichenfolge, die den Typ des Objekts angibt, auf das zugegriffen wird. Dieser Parameter muss entweder "File" oder "Key" lauten, je nachdem, ob es sich bei dem Objekt um eine Datei oder Registrierung handelt. Diese Zeichenfolge wird in jeder Von der Funktion generierten Überwachungsmeldung angezeigt.

[out] Acl

Ein Zeiger auf eine ACL- Struktur, die die SACL-Informationen enthält. Dies sollte später durch Aufrufen der funktion LocalFree freigegeben werden.

Rückgabewert

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

Wenn die Funktion fehlschlägt, wird FALSE-zurückgegeben. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten. GetLastError- kann einen der folgenden Fehlercodes zurückgeben, die in WinError.h definiert sind.

Bemerkungen

Um diese Funktion erfolgreich aufzurufen, muss der Aufrufer SeSecurityPrivilegehaben.

Anforderungen