ITableData::HrEnumRow
Aplica-se a: Outlook 2013 | Outlook 2016
Recupera uma linha com base em sua posição na tabela.
HRESULT HrEnumRow(
ULONG ulRowNumber,
LPSRow FAR * lppSRow
);
Parâmetros
ulRowNumber
[in] O número da linha para a qual retornar propriedades. O valor no parâmetro ulRowNumber pode ser qualquer valor de 0, o que indica a primeira linha na tabela, por meio de n - 1, que indica a última linha na tabela.
lppSRow
[out] Um ponteiro para um ponteiro para uma estrutura SRow que descreve a linha de destino.
Valor de retorno
S_OK
A linha foi recuperada com êxito ou não existe uma linha para o número de linha especificado pelo parâmetro ulRowNumber .
Comentários
O método ITableData::HrEnumRow recupera uma linha com base em um número sequencial. Esse número representa a ordem de inserção (0 indica a primeira linha e o número de linhas menos 1 indica a última linha). O MAPI mantém essa ordem cronológica de inserção de linha para o tempo de vida do objeto de dados da tabela.
Se o número especificado em ulRowNumber não corresponder a uma linha na tabela, HrEnumRow retornará S_OK e definirá o parâmetro lppSRow como NULL.
MAPI aloca memória para a estrutura SRow retornada usando a função MAPIAllocateBuffer quando o objeto de dados de tabela é criado. O chamador deve liberar essa memória chamando a função MAPIFreeBuffer .
Para recuperar linhas de uma tabela na ordem em que foram inseridas, os usuários do objeto de dados de tabela chamam o método HrEnumRow .