IMAPISupport::GetOneOffTable
Aplica-se a: Outlook 2013 | Outlook 2016
Retorna um ponteiro para a tabela única MAPI (uma lista de modelos que todos os provedores de catálogo de endereços dão suporte para a criação de novos destinatários).
HRESULT GetOneOffTable(
ULONG ulFlags,
LPMAPITABLE FAR * lppTable
);
Parâmetros
ulFlags
[in] Um bitmask de sinalizadores que controla o tipo de colunas de cadeia de caracteres. O seguinte sinalizador pode ser definido:
MAPI_UNICODE
As colunas de cadeia de caracteres estão no formato Unicode. Se o sinalizador MAPI_UNICODE não estiver definido, as colunas de cadeia de caracteres estarão no formato ANSI.
lppTable
[out] Um ponteiro para um ponteiro para a tabela única.
Valor de retorno
S_OK
A tabela única foi recuperada com êxito.
Comentários
O método IMAPISupport::GetOneOffTable é implementado para objetos de suporte do provedor de catálogo de endereços. Os provedores de catálogo de endereços chamam GetOneOffTable para recuperar a lista completa de modelos para criar novos destinatários. Esta tabela inclui modelos que abordam provedores de livros que estão ativos no suporte à sessão, bem como modelos compatíveis com MAPI.
Os destinatários recém-criados podem ser usados para resolver uma mensagem ou podem ser adicionados a um contêiner de catálogo de endereços.
Para obter uma lista das propriedades que compõem o conjunto de colunas necessário em tabelas pontuais, confira Tabelas pontuais.
Definir o sinalizador MAPI_UNICODE no parâmetro ulFlags afeta o formato das colunas retornadas dos métodos IMAPITable::QueryColumns e IMAPITable::QueryRows . Esse sinalizador também controla os tipos de propriedade na ordem de classificação retornada pelo método IMAPITable::QuerySortOrder .
Notas para chamadores
Se você estiver registrado para receber notificações de alterações nessa tabela única, também receberá notificações de alterações nas tabelas pontuais de outros provedores. Com base nessas notificações, você pode dar suporte a novos tipos de endereço que são adicionados durante a sessão atual.