ITableData::HrModifyRow
S’applique à : Outlook 2013 | Outlook 2016
Insère une nouvelle ligne de tableau, éventuellement en remplaçant une ligne existante.
HRESULT HrModifyRow(
LPSRow lpSRow
);
Paramètres
lpSRow
[in] Pointeur vers une structure SRow qui décrit la ligne à ajouter ou à remplacer une ligne existante. L’une des structures de valeurs de propriété pointées par le membre lpProps de la structure SRow 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
La ligne a été insérée ou modifiée avec succès.
MAPI_E_INVALID_PARAMETER
La ligne passée n’a pas de colonne d’index.
Remarques
La méthode ITableData ::HrModifyRow insère la ligne décrite par la structure SRow pointée vers le paramètre lpSRow . Si une ligne qui a la même valeur pour sa colonne d’index que la ligne vers laquelle lpSRow pointe existe déjà dans la table, la ligne existante est remplacée. S’il n’existe aucune ligne qui correspond à celle incluse dans la structure SRow , HrModifyRow ajoute la ligne à la fin de la table.
Toutes les vues de la table sont modifiées pour inclure la ligne pointée par lpSRow. Toutefois, si une vue a une restriction qui exclut la ligne, il se peut qu’elle ne soit pas visible par l’utilisateur.
Les colonnes de la ligne pointées par lpSRow 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, HrModifyRow rend ces nouvelles colonnes disponibles, mais ne les inclut pas dans l’ensemble de colonnes actuel. Pour les affichages futurs, HrModifyRow inclut les nouvelles colonnes dans l’ensemble de colonnes.
Une fois que HrModifyRow a ajouté la ligne, 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.