ITableData::HrEnumRow
Область применения: Outlook 2013 | Outlook 2016
Извлекает строку на основе ее положения в таблице.
HRESULT HrEnumRow(
ULONG ulRowNumber,
LPSRow FAR * lppSRow
);
Параметры
ulRowNumber
[в] Номер строки, для которой возвращаются свойства. Значение в параметре ulRowNumber может быть любым значением от 0, которое указывает на первую строку в таблице, по n - 1, указывающее последнюю строку в таблице.
lppSRow
[out] Указатель на указатель на структуру SRow , которая описывает целевую строку.
Возвращаемое значение
S_OK
Строка получена успешно или строка для номера строки, указанного параметром ulRowNumber , не существует.
Замечания
Метод ITableData::HrEnumRow извлекает строку на основе последовательного числа. Это число представляет порядок вставки (0 обозначает первую строку, а число строк минус 1 — последнюю строку). MAPI поддерживает этот хронологический порядок вставки строк в течение времени существования объекта данных таблицы.
Если число, указанное в ulRowNumber , не соответствует строке в таблице, HrEnumRow возвращает S_OK и задает для параметра lppSRow значение NULL.
MAPI выделяет память для возвращаемой структуры SRow с помощью функции MAPIAllocateBuffer при создании объекта данных таблицы. Вызывающий объект должен освободить эту память, вызвав функцию MAPIFreeBuffer .
Чтобы получить строки из таблицы в том порядке, в который они были вставлены, пользователи объектов данных таблицы вызывают метод HrEnumRow .