Recuperando dados de linhas de tabela
Aplica-se a: Outlook 2013 | Outlook 2016
A recuperação de linhas de uma tabela envolve:
Obtendo os valores de propriedade para todas as colunas.
Modificando a posição atual.
Uma das colunas necessárias na maioria das tabelas é um identificador de entrada – a propriedade PR_ENTRYID (PidTagEntryId) – que pode ser usado para abrir o objeto que representa a linha. Esse identificador de entrada geralmente é um identificador de entrada de curto prazo, que não persiste após o tempo de vida da tabela. No entanto, ele pode ser um identificador de longo prazo se o provedor de serviços que implementa a tabela apenas dá suporte a um tipo de identificador de entrada.
Clientes e provedores de serviços podem fazer uma das seguintes chamadas para recuperar linhas:
| Chamada | Descrição |
|---|---|
|
IMAPITable::QueryRows |
Recupera um número especificado de linhas começando com a linha atual em uma direção para frente ou para trás. |
|
HrQueryAllRows |
Recupera todas as linhas em uma tabela. |
|
ITableData::HrQueryRow |
Recupera uma linha em uma tabela de acordo com o valor de sua coluna de índice. PR_INSTANCE_KEY (PidTagInstanceKey) geralmente é a coluna de índice de uma tabela. |
Quando uma propriedade opcional é incluída como uma das colunas em uma tabela, algumas das linhas podem ter valores válidos para a coluna, enquanto outras podem não ter. Se existe um valor válido para uma coluna depende se o objeto que fornece as informações para a linha define a propriedade. Dependendo da implementação do objeto, uma propriedade inexistente pode ser representada na tabela como PR_NULL (PidTagNull) ou um valor arbitrário. Os usuários de tabelas devem ter cuidado para diferenciar entre propriedades que são inexistentes e têm valores e propriedades sem sentido que existem e têm valores válidos.