ITableData::HrModifyRow
Aplica-se a: Outlook 2013 | Outlook 2016
Insere uma nova linha de tabela, possivelmente substituindo uma linha existente.
HRESULT HrModifyRow(
LPSRow lpSRow
);
Parâmetros
lpSRow
[in] Um ponteiro para uma estrutura SRow que descreve a linha a ser adicionada ou para substituir uma linha existente. Uma das estruturas de valor da propriedade apontadas pelo membro lpProps da estrutura SRow deve conter a coluna de índice, o mesmo valor especificado no parâmetro ulPropTagIndexColumn na chamada para a função CreateTable .
Valor de retorno
S_OK
A linha foi inserida ou modificada com êxito.
MAPI_E_INVALID_PARAMETER
A linha passada não tem uma coluna de índice.
Comentários
O método ITableData::HrModifyRow insere a linha descrita pela estrutura SRow apontada pelo parâmetro lpSRow . Se uma linha que tem o mesmo valor para sua coluna de índice que a linha que lpSRow aponta já existir na tabela, a linha existente será substituída. Se não existir nenhuma linha que corresponda à incluída na estrutura SRow , HrModifyRow adicionará a linha ao final da tabela.
Todas as exibições da tabela são modificadas para incluir a linha apontada por lpSRow. No entanto, se uma exibição tiver uma restrição em vigor que exclua a linha, ela poderá não estar visível para o usuário.
As colunas na linha apontadas por lpSRow não precisam estar na mesma ordem que as colunas na tabela. O chamador também pode incluir como propriedades de colunas que não estão atualmente na tabela. Para exibições existentes, HrModifyRow disponibiliza essas novas colunas, mas não as inclui no conjunto de colunas atual. Para exibições futuras, HrModifyRow inclui as novas colunas no conjunto de colunas.
Depois que HrModifyRow adiciona a linha, 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.