Compartilhar via


ITableData::HrDeleteRow

Aplica-se a: Outlook 2013 | Outlook 2016

Exclui uma linha de tabela.

HRESULT HrDeleteRow(
  LPSPropValue lpSPropValue
);

Parâmetros

lpSPropValue

[in] Um ponteiro para uma estrutura de valor de propriedade que descreve a coluna de índice para a linha a ser excluída. O membro ulPropTag da estrutura de valor da propriedade deve conter a mesma marca de propriedade que o parâmetro ulPropTagIndexColumn da chamada para a função CreateTable .

Valor de retorno

S_OK

A linha foi excluída com êxito.

MAPI_E_NOT_FOUND

A propriedade apontada pelo parâmetro lpSPropValue não identifica uma linha na tabela.

Comentários

O método ITableData::HrDeleteRow remove a linha de tabela que contém a coluna que corresponde à propriedade apontada pelo parâmetro lpSPropValue . Os dados da linha são excluídos e a linha é removida de todas as exibições abertas.

Depois que a linha é excluída, 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 uma linha não reduz o conjunto de colunas que está disponível para exibições existentes ou exibições abertas posteriormente, mesmo que a linha excluída seja a última linha que tem um valor para uma coluna específica.

Confira também

CreateTable

ITableData::HrDeleteRows

ITableData::HrModifyRow

SPropValue

TABLE_NOTIFICATION

ITableData : IUnknown