AuditQuerySystemPolicy-Funktion (ntsecapi.h)

Die AuditQuerySystemPolicy-Funktion ruft die Systemüberwachungsrichtlinie für mindestens eine Audit-Policy-Unterkategorie ab.

Syntax

BOOLEAN AuditQuerySystemPolicy(
  [in]  const GUID                *pSubCategoryGuids,
  [in]  ULONG                     dwPolicyCount,
  [out] PAUDIT_POLICY_INFORMATION *ppAuditPolicy
);

Parameter

[in] pSubCategoryGuids

Ein Zeiger auf ein Array von GUID-Werten , die die Unterkategorien angeben, für die die Überwachungsrichtlinie abgefragt werden soll. Eine Liste der definierten Überwachungsrichtlinienunterkategorien finden Sie unter Überwachungskonstanten.

[in] dwPolicyCount

Die Anzahl der Elemente in den einzelnen pSubCategoryGuids - und ppAuditPolicy-Arrays .

[out] ppAuditPolicy

Ein Zeiger auf einen einzelnen Puffer, der sowohl ein Array von Zeigern auf AUDIT_POLICY_INFORMATION Strukturen als auch die Strukturen selbst enthält. Die AUDIT_POLICY_INFORMATION Strukturen geben die Systemüberwachungsrichtlinie für die Vom pSubCategoryGuids-Array angegebenen Unterkategorien an.

Wenn Sie mit der Verwendung dieses Puffers fertig sind, geben Sie ihn frei, indem Sie die AuditFree-Funktion aufrufen.

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.

Hinweise

Um diese Funktion erfolgreich aufzurufen, muss der Aufrufer über SeSecurityPrivilege oder über AUDIT_QUERY_SYSTEM_POLICY Zugriff auf das Überwachungssicherheitsobjekt verfügen.

Anforderungen