Fonction AuthzReportSecurityEvent (authz.h)
La fonction AuthzReportSecurityEvent génère un audit de sécurité pour une source d’événement de sécurité inscrite.
L’audit de la catégorie d’événements d’accès à l’objet doit être activé pour que la fonction AuthzReportSecurityEvent génère un audit de sécurité. Les types d’audit disponibles sont définis dans l’énumération AUDIT_PARAM_TYPE .
Syntaxe
AUTHZAPI BOOL AuthzReportSecurityEvent(
[in] DWORD dwFlags,
[in, out] AUTHZ_SECURITY_EVENT_PROVIDER_HANDLE hEventProvider,
[in] DWORD dwAuditId,
[in, optional] PSID pUserSid,
[in] DWORD dwCount,
...
);
Paramètres
[in] dwFlags
Indicateurs qui spécifient le type d’audit généré. Le tableau suivant répertorie les valeurs possibles.
| Value | Signification |
|---|---|
|
Des audits d’échec sont générés. |
|
Des audits de réussite sont générés. |
[in, out] hEventProvider
Handle de la source d’événements de sécurité inscrite à utiliser pour l’audit.
[in] dwAuditId
Identificateur de l’audit.
[in, optional] pUserSid
Pointeur vers l’identificateur de sécurité (SID) qui sera répertorié comme source de l’audit dans le journal des événements.
[in] dwCount
Nombre de paires type/valeur AuditParamFlag qui apparaissent dans la section arguments variables qui suit ce paramètre.
...
Liste des paires type/valeur AuditParamFlag qui fournissent des informations supplémentaires sur l’événement.
Valeur retournée
Si la fonction réussit, la fonction retourne TRUE.
Si la fonction échoue, elle retourne FALSE. Pour obtenir des informations d’erreur étendues, appelez GetLastError.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Aucun pris en charge |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | authz.h |
| Bibliothèque | Authz.lib |
| DLL | Authz.dll |
| Composant redistribuable | Pack outils d’administration Windows Server 2003 sur Windows XP |