structure STD_ALERT (lmalert.h)

Article
08/24/2023

La structure STD_ALERT contient l’heure et la date à laquelle un événement important s’est produit. La structure contient également une classe d’alerte et le nom de l’application qui déclenche le message d’alerte. Vous devez spécifier la structure STD_ALERT lorsque vous envoyez un message d’alerte à l’aide de la fonction NetAlertRaise .

Syntaxe

typedef struct _STD_ALERT {
  DWORD alrt_timestamp;
  WCHAR alrt_eventname[EVLEN + 1];
  WCHAR alrt_servicename[SNLEN + 1];
} STD_ALERT, *PSTD_ALERT, *LPSTD_ALERT;

Membres

alrt_timestamp

Type : DWORD

Heure et date de l’événement. Cette valeur est stockée sous la forme du nombre de secondes qui se sont écoulées depuis 00:00:00, le 1er janvier 1970, GMT.

alrt_eventname[EVLEN + 1]

Type : WCHAR[EVLEN + 1]

Chaîne Unicode indiquant la classe d’alerte (type d’événement). Ce paramètre peut être l’une des valeurs prédéfinies suivantes ou une autre classe d’alerte que vous avez définie pour les applications réseau. (Le nom d’événement d’une alerte peut être n’importe quelle chaîne de texte.)

Name	Signification
ALERT_ADMIN_EVENT	L’intervention d’un administrateur est requise.
ALERT_ERRORLOG_EVENT	Une entrée a été ajoutée au journal des erreurs.
ALERT_MESSAGE_EVENT	Un utilisateur ou une application a reçu un message de diffusion.
ALERT_PRINT_EVENT	Un travail d’impression a été effectué ou une erreur d’impression s’est produite.
ALERT_USER_EVENT	Une application ou une ressource a été utilisée.

alrt_servicename[SNLEN + 1]

Type : WCHAR[SNLEN + 1]

Chaîne Unicode indiquant l’application de service qui déclenche le message d’alerte.

Notes

La structure STD_ALERT doit être suivie d’une structure ADMIN_OTHER_INFO, ERRLOG_OTHER_INFO, PRINT_OTHER_INFO ou USER_OTHER_INFO . Ces structures peuvent éventuellement être suivies de données de longueur variable. L’application appelante doit allouer la mémoire pour toutes les structures et données de longueur variable dans une mémoire tampon de message d’alerte.

Consultez NetAlertRaise pour obtenir un exemple de code qui déclenche une alerte administrative à l’aide d’une structure STD_ALERT et d’une structure ADMIN_OTHER_INFO .

Configuration requise


Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	lmalert.h (inclure Lm.h)