ITableData::HrInsertRow
S’applique à : Outlook 2013 | Outlook 2016
Insère une ligne de tableau.
HRESULT HrInsertRow(
ULONG uliRow,
LPSRow lpSRow
);
Paramètres
uliRow
[in] Numéro de ligne séquentiel qui représente une ligne spécifique. La nouvelle ligne est placée après la ligne que le nombre indique. Le paramètre uliRow peut contenir des numéros de ligne compris entre 0 et n, où n est le nombre total de lignes dans la table. Le passage de n dans uliRow ajoute la ligne à la fin de la table.
lpSRow
[in] Pointeur vers une structure SRow qui décrit la ligne à insérer.
Valeur renvoyée
S_OK
La ligne a été insérée avec succès.
MAPI_E_INVALID_PARAMETER
Une ligne qui a la même valeur pour sa colonne d’index que la ligne à insérer existe déjà dans la table.
Remarques
La méthode ITableData ::HrInsertRow insère une ligne dans une table à une position particulière. La nouvelle ligne est insérée après la ligne qui se trouve à la position spécifiée par le paramètre uliRow .
Si uliRow est défini sur le nombre de lignes de la table, la nouvelle ligne est ajoutée à la fin du tableau.
La propriété qui fait office de colonne d’index pour la table doit être incluse dans le membre lpProps de la structure SRow vers laquelle pointe le paramètre lpSRow . Cette propriété d’index, généralement PR_INSTANCE_KEY (PidTagInstanceKey), est utilisée pour identifier de manière unique la ligne pour les tâches de maintenance futures.
Les colonnes de propriété dans la structure SRow ne doivent pas être dans le même ordre que les colonnes de propriété dans la table.
Une fois la ligne insérée, 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. Aucune notification n’est envoyée si la ligne insérée n’est pas incluse dans la vue en raison d’une restriction.