Partager via


ScCountNotifications

S’applique à : Outlook 2013 | Outlook 2016

Détermine la taille, en octets, d’un tableau de notifications d’événements et valide la mémoire associée au tableau.

Propriété Valeur
Fichier d’en-tête :
Mapiutil.h
Implémenté par :
MAPI
Appelé par :
Applications clientes et fournisseurs de services
SCODE ScCountNotifications(
  int cntf,
  LPNOTIFICATION rgntf,
  ULONG FAR * pcb
);

Paramètres

cntf

[in] Nombre de structures NOTIFICATION dans le tableau indiqué par le paramètre rgntf .

rgntf

[in] Pointeur vers le tableau de structures NOTIFICATION dont la taille doit être déterminée.

Pcb

[out] Pointeur facultatif vers la taille, en octets, du tableau vers lequel pointe le paramètre rgntf . Si la valeur est NULL, ScCountNotifications valide le tableau de notifications.

Valeur renvoyée

S_OK

Le nombre a été déterminé avec succès.

MAPI_E_INVALID_PARAMETER

Une notification non valide a été rencontrée.

Remarques

Si NULL est passé dans le paramètre de circuit imprimé , la fonction ScCountNotifications valide uniquement le tableau des notifications, mais aucun comptage n’est effectué ; si une valeur non null est passée dans un circuit imprimé, ScCountNotifications détermine la taille du tableau et stocke le circuit imprimé à l’origine. Le paramètre de circuit imprimé doit être suffisamment grand pour contenir l’ensemble du tableau.