ITableData::HrQueryRow
S’applique à : Outlook 2013 | Outlook 2016
Récupère une ligne de table.
HRESULT HrQueryRow(
LPSPropValue lpSPropValue,
LPSRow FAR * lppSRow,
ULONG FAR * lpuliRow
);
Paramètres
lpSPropValue
[in] Pointeur vers une structure de valeurs de propriété qui décrit la colonne d’index de la ligne à récupérer. Le membre ulPropTag de la structure de valeur de propriété doit contenir la même balise de propriété que le paramètre ulPropTagIndexColumn de l’appel à la fonction CreateTable , qui accède à l’implémentation ITableData .
lppSRow
[out] Pointeur vers un pointeur vers la ligne récupérée.
lpuliRow
[in, out] En entrée, pointeur valide ou NULL, qui indique qu’aucune information ne doit être retournée. En sortie, pointeur valide qui pointe vers le numéro de ligne de la ligne, un nombre séquentiel qui identifie la position de la ligne dans la table.
Valeur renvoyée
S_OK
La ligne a été récupérée avec succès.
MAPI_E_INVALID_PARAMETER
La structure SPropValue vers laquelle lpSPropValue pointe ne contient pas la propriété de colonne d’index.
Remarques
La méthode ITableData ::HrQueryRow récupère toutes les propriétés de la ligne qui a une colonne d’index qui correspond à la valeur de la colonne d’index incluse dans la structure de propriété pointée par lpSPropValue. HrQueryRow retourne également le numéro de ligne, si l’appelant le demande, qui identifie la position de la ligne dans la table.
Étant donné que HrQueryRow ne modifie pas la structure SPropValue pointée par lpSPropValue, les appelants doivent libérer la structure lorsque HrQueryRow est retourné. Les appelants doivent également libérer la structure SRow qui contient la ligne récupérée.