Fonction AuthzReportSecurityEvent (authz.h)

  • Article

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
APF_AuditFailure
0x00000000
 Des audits d’échec sont générés.
APF_AuditSuccess
0x00000001
 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

Voir aussi

AuthzRegisterSecurityEventSource

AuthzReportSecurityEventFromParams