ITableData::HrInsertRow
Aplica-se a: Outlook 2013 | Outlook 2016
Insere uma linha de tabela.
HRESULT HrInsertRow(
ULONG uliRow,
LPSRow lpSRow
);
Parâmetros
uliRow
[in] Um número de linha sequencial que representa uma linha específica. A nova linha será colocada após a linha que o número indica. O parâmetro uliRow pode conter números de linha de 0 a n, em que n é o número total de linhas na tabela. Passar n em uliRow acrescenta a linha ao final da tabela.
lpSRow
[in] Um ponteiro para uma estrutura SRow que descreve a linha a ser inserida.
Valor de retorno
S_OK
A linha foi inserida com êxito.
MAPI_E_INVALID_PARAMETER
Uma linha que tem o mesmo valor para sua coluna de índice que a linha a ser inserida já existe na tabela.
Comentários
O método ITableData::HrInsertRow insere uma linha em uma tabela em uma posição específica. A nova linha é inserida após a linha que está na posição especificada pelo parâmetro uliRow .
Se uliRow estiver definido como o número de linhas na tabela, a nova linha será anexada ao final da tabela.
A propriedade que atua como a coluna de índice da tabela deve ser incluída no membro lpProps da estrutura SRow apontada pelo parâmetro lpSRow . Essa propriedade de índice, normalmente PR_INSTANCE_KEY (PidTagInstanceKey), é usada para identificar exclusivamente a linha para tarefas futuras de manutenção.
As colunas de propriedade na estrutura SRow não precisam estar na mesma ordem que as colunas de propriedade na tabela.
Depois que a linha é inserida, 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. Nenhuma notificação será enviada se a linha inserida não estiver incluída no modo de exibição devido a uma restrição.