Fonction AuthzRegisterSecurityEventSource (authz.h)
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 |