ITableData::HrEnumRow
S’applique à : Outlook 2013 | Outlook 2016
Récupère une ligne en fonction de sa position dans la table.
HRESULT HrEnumRow(
ULONG ulRowNumber,
LPSRow FAR * lppSRow
);
Paramètres
ulRowNumber
[in] Numéro de la ligne pour laquelle les propriétés doivent être retournées. La valeur dans le paramètre ulRowNumber peut être n’importe quelle valeur comprise entre 0, ce qui indique la première ligne de la table, jusqu’à n - 1, ce qui indique la dernière ligne de la table.
lppSRow
[out] Pointeur vers un pointeur vers une structure SRow qui décrit la ligne cible.
Valeur renvoyée
S_OK
La ligne a été récupérée avec succès ou une ligne pour le numéro de ligne spécifié par le paramètre ulRowNumber n’existe pas.
Remarques
La méthode ITableData ::HrEnumRow récupère une ligne en fonction d’un nombre séquentiel. Ce nombre représente l’ordre d’insertion (0 indique la première ligne et le nombre de lignes moins 1 indique la dernière ligne). MAPI conserve cet ordre chronologique d’insertion de ligne pendant la durée de vie de l’objet de données de table.
Si le nombre spécifié dans ulRowNumber ne correspond pas à une ligne de la table, HrEnumRow renvoie S_OK et définit le paramètre lppSRow sur NULL.
MAPI alloue de la mémoire pour la structure SRow retournée à l’aide de la fonction MAPIAllocateBuffer lors de la création de l’objet de données de table. L’appelant doit libérer cette mémoire en appelant la fonction MAPIFreeBuffer .
Pour récupérer des lignes d’une table dans l’ordre dans lequel elles ont été insérées, les utilisateurs de l’objet de données de table appellent la méthode HrEnumRow .