ScCountProps
S’applique à : Outlook 2013 | Outlook 2016
Détermine la taille, en octets, d’un tableau de valeurs de propriété 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 ScCountProps(
int cprop,
LPSPropValue rgprop,
ULONG FAR * pcb
);
Paramètres
cprop
[in] Nombre de propriétés dans le tableau indiqué par le paramètre rgprop .
rgprop
[in] Pointeur vers une plage dans un tableau de structures SPropValue qui définit les propriétés dont la taille doit être déterminée. Cette plage ne commence pas nécessairement au début du tableau.
Pcb
[out] Pointeur facultatif vers la taille, en octets, du tableau de propriétés.
Valeur renvoyée
S_OK
L'appel a r�ussi et a renvoy� la valeur attendue ou les valeurs.
MAPI_E_INVALID_PARAMETER
Au moins une propriété dans le tableau de valeurs de propriété a un identificateur de PROP_ID_NULL ou de PROP_ID_INVALID, ou le tableau de propriétés contient une propriété à valeurs multiples sans valeur de propriété.
Remarques
Si NULL est passé dans le paramètre de circuit imprimé , la fonction ScCountProps valide le tableau des notifications, mais aucun comptage n’est effectué. Si une valeur non null est passée dans un circuit imprimé, la fonction ScCountNotifications détermine la taille du tableau et stocke le circuit imprimé cause. Le paramètre de circuit imprimé doit être suffisamment grand pour contenir l’ensemble du tableau.
Au fur et à mesure du comptage, ScCountProps valide la mémoire associée au tableau. ScCountProps fonctionne uniquement avec les propriétés sur lesquelles MAPI contient des informations.