AuthzInitializeObjectAccessAuditEvent2, fonction (authz.h)

Article
08/22/2023

La fonction AuthzInitializeObjectAccessAuditEvent2 alloue et initialise un handle AUTHZ_AUDIT_EVENT_HANDLE à utiliser avec la fonction AuthzAccessCheck .

Syntaxe

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

Paramètres

[in] Flags

Indicateurs qui modifient le comportement de l’audit. Le tableau suivant répertorie les valeurs possibles.

Value	Signification
AUTHZ_NO_ALLOC_STRINGS	Utilise 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.
AUTHZ_NO_FAILURE_AUDIT	Désactive la génération d’audits d’échec.
AUTHZ_NO_SUCCESS_AUDIT	Désactive la génération d’audits de réussite.

[in] hAuditEventType

Réservé. Ce paramètre doit être défini sur NULL.

[in] szOperationType

Pointeur vers une chaîne qui indique l’opération à auditer.

[in] szObjectType

Pointeur vers une chaîne qui indique le type d’objet consulté.

[in] szObjectName

Pointeur vers une chaîne qui indique le nom de l’objet consulté.

[in] szAdditionalInfo

Pointeur vers une chaîne définie par le Resource Manager qui contient des informations d’audit supplémentaires.

[in] szAdditionalInfo2

Pointeur vers une chaîne définie par le Resource Manager qui contient des informations d’audit supplémentaires.

[out] phAuditEvent

Pointeur vers le handle de AUTHZ_AUDIT_EVENT_HANDLE retourné.

[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	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	Windows Server 2003 Administration Tools Pack sur Windows XP

Voir aussi

AuthzAccessCheck

Fonctions Access Control de base