Partager via


AuthzInitializeObjectAccessAuditEvent2, fonction (authz.h)

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