AuthzInitializeObjectAccessAuditEvent, fonction (authz.h)

Article
02/26/2024

La fonction AuthzInitializeObjectAccessAuditEvent initialise l’audit pour un objet.

Syntaxe

AUTHZAPI BOOL AuthzInitializeObjectAccessAuditEvent(
  [in]  DWORD                         Flags,
  [in]  AUTHZ_AUDIT_EVENT_TYPE_HANDLE hAuditEventType,
  [in]  PWSTR                         szOperationType,
  [in]  PWSTR                         szObjectType,
  [in]  PWSTR                         szObjectName,
  [in]  PWSTR                         szAdditionalInfo,
  [out] PAUTHZ_AUDIT_EVENT_HANDLE     phAuditEvent,
  [in]  DWORD                         dwAdditionalParameterCount,
        ...                           
);

Paramètres

[in] Flags

Modifie l’audit. Ce paramètre peut prendre les valeurs suivantes.

Valeur	Signification
AUTHZ_NO_SUCCESS_AUDIT	Désactivez la génération d’audits de réussite.
AUTHZ_NO_FAILURE_AUDIT	Désactivez la génération d’audits d’échec.
AUTHZ_NO_ALLOC_STRINGS	Utilisez des pointeurs vers les chaînes passées au lieu d’allouer de la mémoire et de copier les chaînes. L’application appelante doit s’assurer que la mémoire passée reste valide pendant les vérifications d’accès.

[in] hAuditEventType

Réservé. Ce paramètre doit avoir la valeur NULL.

[in] szOperationType

Chaîne qui indique l’opération à auditer.

[in] szObjectType

Chaîne qui indique le type d’objet auquel vous accédez.

[in] szObjectName

Chaîne indiquant le nom de l’objet auquel vous accédez.

[in] szAdditionalInfo

Chaîne, définie par le Resource Manager, pour obtenir des informations d’audit supplémentaires.

[out] phAuditEvent

Pointeur qui reçoit une structure AUTHZ_AUDIT_EVENT_HANDLE .

[in] dwAdditionalParameterCount

Doit être défini sur zéro.

...

Paramètres supplémentaires.

Valeur retournée

Si la fonction réussit, elle 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	Windows XP [applications de bureau uniquement]
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

AuthzAccessCheck

Fonctions Access Control de base

Partager via