ITableData::HrDeleteRows
S’applique à : Outlook 2013 | Outlook 2016
Supprime plusieurs lignes de table.
HRESULT HrDeleteRows(
ULONG ulFlags,
LPSRowSet lprowsetToDelete,
ULONG FAR * cRowsDeleted
);
Paramètres
ulFlags
[in] Masque de bits d’indicateurs qui contrôle la suppression. L’indicateur suivant peut être défini :
TAD_ALL_ROWS
Supprime toutes les lignes de la table et toutes les vues correspondantes, en envoyant une notification TABLE_RELOAD unique.
lprowsetToDelete
[in] Pointeur vers un jeu de lignes qui décrit les lignes à supprimer. Le paramètre lprowsetToDelete peut être NULL si l’indicateur TAD_ALL_ROWS est défini dans le paramètre ulFlags .
cRowsDeleted
[out] Nombre de lignes supprimées.
Valeur renvoyée
S_OK
Les lignes de la table ont été supprimées avec succès.
Remarques
La méthode ITableData ::HrDeleteRows localise et supprime les lignes de table qui contiennent les colonnes qui correspondent à la propriété pointée par le membre lpProps de chaque entrée aRow dans le jeu de lignes. Une colonne d’index est utilisée pour identifier chaque ligne ; cette colonne doit avoir la même balise de propriété que la balise de propriété passée dans le paramètre ulPropTagIndexColumn dans l’appel à la fonction CreateTable .
Le nombre de lignes réellement supprimées est retourné dans cRowsDeleted. Aucune erreur n’est retournée si une ou plusieurs lignes sont introuvables.
Une fois les lignes supprimées, des notifications sont envoyées à tous les clients ou fournisseurs de services qui ont une vue de la table et qui ont appelé la méthode IMAPITable ::Advise de la table pour s’inscrire aux notifications.
La suppression de lignes ne réduit pas les colonnes disponibles pour les vues table existantes ou les vues de table ouvertes par la suite, même si les lignes supprimées sont les dernières qui ont des valeurs pour une colonne spécifique.