Fonction AuthzRegisterSecurityEventSource (authz.h)

  • Article

La fonction AuthzRegisterSecurityEventSource inscrit une source d’événement de sécurité auprès de l’autorité de sécurité locale (LSA).

Syntaxe

AUTHZAPI BOOL AuthzRegisterSecurityEventSource(
  [in]  DWORD                                 dwFlags,
  [in]  PCWSTR                                szEventSourceName,
  [out] PAUTHZ_SECURITY_EVENT_PROVIDER_HANDLE phEventProvider
);

Paramètres

[in] dwFlags

Ce paramètre est réservé à un usage futur. Définissez ce paramètre sur zéro.

[in] szEventSourceName

Pointeur vers le nom de la source d’événement de sécurité à inscrire.

[out] phEventProvider

Pointeur vers un handle vers la source d’événement de sécurité inscrite.

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.

Remarques

Cette fonction valide le paramètre szEventSourceName et configure les structures et connexions RPC appropriées pour journaliser les événements portant ce nom source. La validation est gérée par un appel sous-jacent à une API LSA.

L’API LSA vérifie les éléments suivants :

  • L’appelant dispose du droit d’accès SeAuditPrivilege.
  • La source d’événement n’est pas encore en cours d’utilisation.
  • La source d’événement est inscrite.
  • L’application appelante correspond au chemin d’accès de l’image exécutable dans l’inscription de la source d’événement, le cas échéant.

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

AuthzUnregisterSecurityEventSource