IMAPITable::QueryColumns
Aplica-se a: Outlook 2013 | Outlook 2016
Retorna uma lista de colunas para a tabela.
HRESULT QueryColumns(
ULONG ulFlags,
LPSPropTagArray FAR * lpPropTagArray
);
Parâmetros
ulFlags
[in] Bitmask de sinalizadores que indica qual conjunto de colunas deve ser retornado. O seguinte sinalizador pode ser definido:
TBL_ALL_COLUMNS
A tabela deve retornar todas as colunas disponíveis.
Lpproptagarray
[out] Ponteiro para uma estrutura SPropTagArray que contém as marcas de propriedade para o conjunto de colunas.
Valor de retorno
S_OK
O conjunto de colunas foi retornado com êxito.
MAPI_E_BUSY
Outra operação está em andamento que impede o início da operação de recuperação do conjunto de colunas. A operação em andamento deve ser autorizada a ser concluída ou deve ser interrompida.
Comentários
O método IMAPITable::QueryColumns pode ser chamado para recuperar:
O conjunto de colunas padrão para uma tabela.
O conjunto de colunas atual para uma tabela, conforme estabelecido por uma chamada para o método IMAPITable::SetColumns .
O conjunto de colunas completo para uma tabela, as colunas que estão disponíveis, mas não necessariamente parte do conjunto atual.
Notas para chamadores
Se você não definir o sinalizador TBL_ALL_COLUMNS, IMAPITable::QueryColumns retornará o conjunto de colunas padrão ou atual de uma tabela, dependendo se a tabela foi afetada por uma chamada para IMAPITable::SetColumns. SetColumns altera a ordem e a seleção de colunas no conjunto de colunas de uma tabela.
Se você definir o sinalizador TBL_ALL_COLUMNS, QueryColumns retornará todas as colunas capazes de estar no conjunto de colunas da tabela.
Libere a memória da matriz de marcas de propriedade apontada pelo parâmetro lpPropTagArray chamando a função MAPIFreeBuffer .
Referência do MFCMAPI
Para ver códigos de exemplo do MFCMAPI, confira a tabela a seguir.
| Arquivo | Função | Comentário |
|---|---|---|
| ContentsTableListCtrl.cpp |
CContentsTableListCtrl::D oSetColumns |
O MFCMAPI usa o método IMAPITable::QueryColumns para recuperar o conjunto de colunas atual para uma tabela para que o usuário possa editá-la. |