ITableData::HrDeleteRows
Aplica-se a: Outlook 2013 | Outlook 2016
Exclui várias linhas de tabela.
HRESULT HrDeleteRows(
ULONG ulFlags,
LPSRowSet lprowsetToDelete,
ULONG FAR * cRowsDeleted
);
Parâmetros
ulFlags
[in] Um bitmask de sinalizadores que controla a exclusão. O seguinte sinalizador pode ser definido:
TAD_ALL_ROWS
Exclui todas as linhas da tabela e todas as exibições correspondentes, enviando uma única TABLE_RELOAD notificação.
lprowsetToDelete
[in] Um ponteiro para um conjunto de linhas que descreve as linhas a serem excluídas. O parâmetro lprowsetToDelete poderá ser NULL se o sinalizador TAD_ALL_ROWS for definido no parâmetro ulFlags .
cRowsDeleted
[out] A contagem das linhas excluídas.
Valor de retorno
S_OK
As linhas de tabela foram excluídas com êxito.
Comentários
O método ITableData::HrDeleteRows localiza e remove as linhas de tabela que contêm as colunas que correspondem à propriedade apontada pelo membro lpProps de cada entrada aRow no conjunto de linhas. Uma coluna de índice é usada para identificar cada linha; esta coluna deve ter a mesma marca de propriedade que a marca de propriedade passada no parâmetro ulPropTagIndexColumn na chamada para a função CreateTable .
O número de linhas que foram realmente excluídas é retornado em cRowsDeleted. Nenhum erro será retornado se uma ou mais linhas não puderem ser encontradas.
Depois que as linhas são excluídas, as notificações são enviadas a todos os clientes ou provedores de serviços que têm uma exibição da tabela e que chamaram o método IMAPITable::Advise da tabela para se registrar para notificações.
Excluir linhas não reduz as colunas disponíveis para exibições de tabela existentes ou exibições de tabela abertas posteriormente, mesmo que as linhas excluídas sejam as últimas que têm valores para uma coluna específica.