Поделиться через


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 .

См. также

MAPIAllocateBuffer

MAPIFreeBuffer

SRow

ITableData : IUnknown