SRowSet
S’applique à : Outlook 2013 | Outlook 2016
Contient un tableau de structures SRow . Chaque structure SRow décrit une ligne d’une table.
| Propriété | Valeur |
|---|---|
| Fichier d’en-tête : |
Mapidefs.h |
| Macros associées : |
CbNewsRowSet, CbSRowSet, SizedsRowSet |
typedef struct _SRowSet
{
ULONG cRows;
SRow aRow[MAPI_DIM];
} SRowSet, FAR *LPSRowSet;
Members
Corbeaux
Nombre de structures SRow dans le membre aRow .
aRow
Tableau de structures SRow . Il existe une structure pour chaque ligne de la table.
Remarques
Une structure SRowSet est utilisée pour décrire plusieurs lignes de données d’une table. Les structures SRowSet sont utilisées dans les méthodes d’interface IAddrBook, ITableData et IMAPITable, en plus des fonctions suivantes :
Les structures SRowSet sont définies de la même façon que les structures ADRLIST pour permettre le traitement identique des lignes d’une table de destinataires et des entrées d’une liste d’adresses. Les structures SRowSet et ADRLIST peuvent être passées à des méthodes telles que IMessage ::ModifyRecipients et IAddrBook ::Address.
En outre, les règles d’allocation de mémoire pour les structures SRowSet sont les mêmes que pour les structures ADRLIST . Pour résumer, chaque structure SPropValue du tableau pointée par le membre lpProps de chaque ligne du jeu de lignes doit être allouée séparément à l’aide de MAPIAllocateBuffer. Chaque structure de valeur de propriété doit également être libérée à l’aide de MAPIFreeBuffer avant la désallocation de sa structure SRowSet afin que les pointeurs vers les structures SPropValue allouées ne soient pas perdus. La mémoire allouée d’une ligne peut ensuite être conservée et réutilisée en dehors du contexte de la structure SRowSet .
Pour plus d’informations sur la façon dont la mémoire des structures SRowSet doit être allouée, consultez Gestion de la mémoire pour les structures ADRLIST et SRowSet.