IABLogon::GetOneOffTable
Aplica-se a: Outlook 2013 | Outlook 2016
Retorna uma tabela de modelos únicos para criar destinatários a serem adicionados à lista de destinatários de uma mensagem de saída.
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 incluídas na tabela. 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.
MAPI_E_BAD_CHARWIDTH
O sinalizador MAPI_UNICODE foi definido e o provedor de catálogo de endereços não dá suporte ao Unicode ou MAPI_UNICODE não foi definido e o provedor de catálogo de endereços dá suporte apenas ao Unicode.
MAPI_E_NO_SUPPORT
O provedor de catálogo de endereços não fornece modelos únicos.
Comentários
O MAPI chama o método GetOneOffTable para disponibilizar modelos únicos para criar destinatários. Os novos destinatários são adicionados à lista de destinatários de uma mensagem de saída. Os provedores de catálogo de endereços devem dar suporte à notificação em sua tabela única para informar mapi das modificações de modelo. O MAPI mantém a tabela única aberta para habilitar a atualização dinâmica.
Os provedores de catálogo de endereços também podem dar suporte a uma tabela única para cada um de seus contêineres. Os chamadores recuperam essa tabela única chamando o método IMAPIProp::OpenProperty do contêiner e solicitando a propriedade PR_CREATE_TEMPLATES (PidTagCreateTemplates). Os modelos disponíveis por meio desta tabela são usados para adicionar destinatários ao contêiner. Para uma discussão sobre as diferenças entre os dois tipos de tabelas pontuais, consulte Implementando tabelas de One-Off.
Para obter uma lista das colunas necessárias na tabela única de um provedor de catálogo de endereços, consulte Tabelas Pontuais.