Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Aplica-se a: Outlook 2013 | Outlook 2016
Recuperar 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 poderá ser um identificador de longo prazo se o provedor de serviços que implementa a tabela der suporte apenas 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 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 não. A existência ou não de um valor válido para uma coluna depende de o objeto que está fornecendo as informações para a linha definir 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 sem sentido e propriedades que existem e têm valores válidos.