ITableData::HrQueryRow
Область применения: Outlook 2013 | Outlook 2016
Извлекает строку таблицы.
HRESULT HrQueryRow(
LPSPropValue lpSPropValue,
LPSRow FAR * lppSRow,
ULONG FAR * lpuliRow
);
Параметры
lpSPropValue
[в] Указатель на структуру значений свойства, которая описывает столбец индекса для извлекаемой строки. Элемент ulPropTag структуры значения свойства должен содержать тот же тег свойства, что и параметр ulPropTagIndexColumn из вызова функции CreateTable , которая обращается к реализации ITableData .
lppSRow
[out] Указатель на указатель на полученную строку.
lpuliRow
[вход, выход] Во входных данных — допустимый указатель или значение NULL, указывающее, что никаких сведений не требуется возвращать. В выходных данных — допустимый указатель, указывающий на номер строки, последовательный номер, определяющий положение строки в таблице.
Возвращаемое значение
S_OK
Строка успешно получена.
MAPI_E_INVALID_PARAMETER
Структура SPropValue , на которую указывает lpSPropValue , не содержит свойства index column.
Замечания
Метод ITableData::HrQueryRow извлекает все свойства для строки со столбцом индекса, который соответствует значению столбца индекса, включенного в структуру свойств, на которую указывает lpSPropValue. HrQueryRow также возвращает номер строки, если вызывающий запрашивает его, который определяет положение строки в таблице.
Так как HrQueryRow не изменяет структуру SPropValue , на которую указывает lpSPropValue, вызывающие должны освободить структуру при возврате HrQueryRow . Вызывающие элементы также должны освободить структуру SRow , содержащую полученную строку.