ITableData::HrModifyRows
S’applique à : Outlook 2013 | Outlook 2016
Insère plusieurs lignes de table, éventuellement en remplaçant les lignes existantes.
HRESULT HrModifyRows(
ULONG ulFlags,
LPSRowSet lpSRowSet
);
Paramètres
ulFlags
[in] R�serv� ; doit �tre �gal � z�ro.
lpSRowSet
[in] Pointeur vers une structure SRowSet qui contient l’ensemble de lignes à ajouter, en remplaçant les lignes existantes si nécessaire. L’une des structures de valeurs de propriété pointées par le membre lpProps de chaque structure SRow dans le jeu de lignes doit contenir la colonne d’index, la même valeur que celle spécifiée dans le paramètre ulPropTagIndexColumn dans l’appel à la fonction CreateTable .
Valeur renvoyée
S_OK
Les lignes ont été correctement insérées ou modifiées.
MAPI_E_INVALID_PARAMETER
Une ou plusieurs lignes passées n’ont pas de colonne d’index. Si cette erreur est retournée, aucune ligne n’est modifiée.
Remarques
La méthode ITableData ::HrModifyRows insère les lignes décrites par la structure SRowSet pointée par le paramètre lpSRowSet . Si la valeur de colonne d’index d’une ligne dans le jeu de lignes correspond à la valeur d’une ligne existante dans la table, la ligne existante est remplacée. S’il n’existe aucune ligne qui correspond à celle incluse dans la structure SRowSet , HrModifyRows ajoute la ligne à la fin de la table.
Toutes les vues de la table sont modifiées pour inclure les lignes pointées par lpSRowSet. Toutefois, si une vue a une restriction en place qui exclut une ligne, il se peut qu’elle ne soit pas visible par l’utilisateur.
Les colonnes des lignes pointées par lpSRowSet ne doivent pas être dans le même ordre que les colonnes de la table. L’appelant peut également inclure en tant que colonnes des propriétés qui ne se trouvent pas actuellement dans la table. Pour les vues existantes, HrModifyRows rend ces nouvelles colonnes disponibles, mais ne les inclut pas dans l’ensemble de colonnes actuel. Pour les affichages futurs, HrModifyRows inclut les nouvelles colonnes dans l’ensemble de colonnes.
Une fois que HrModifyRows a ajouté les lignes, 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. MAPI envoie des notifications TABLE_ROW_ADDED ou TABLE_ROW_MODIFIED pour chaque ligne, jusqu’à huit lignes. Si plus de huit lignes sont affectées par l’appel HrModifyRows , MAPI envoie une notification TABLE_CHANGED unique à la place.