AuthzInitializeObjectAccessAuditEvent, fonction (authz.h)

  • Article

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