Compartilhar via

Novidades desta edição

  • Artigo

Aplica-se a: Outlook 2013 | Outlook 2016

A Referência MAPI do Microsoft Outlook foi atualizada para incluir documentação para várias novas funcionalidades.

Novo conteúdo

O conteúdo foi adicionado para as seguintes funcionalidades:

Monitor de Inicialização MAPI

  • Por vezes, uma aplicação que consome MAPI poderá querer saber quando a inicialização está concluída. Por exemplo, tem vários threads que podem inicializar a MAPI ou, em resposta à inicialização da MAPI, a aplicação gostaria de realizar algum trabalho, mas não quer sempre aumentar a pilha MAPI. O monitor de inicialização fornece esta funcionalidade através de uma função (exportada de OLMAPI32.DLL) e de algumas interfaces simples descritas abaixo.

HRESULT STDAPICALLTYPE CreateMapiInitializationMonitor(IMAPIInitMonitor ppInitMonitor)

  • Este é o ponto de entrada exportado do OLMAPI32.DLL isto permite que o autor da chamada obtenha uma interface para consultar o estado de inicialização atual, configurar uma chamada de retorno para a conclusão da inicialização ou bloquear o thread atual até estar concluído. O objeto devolvido a partir desta API é reutilizável e seguro para threads e pode ser invocado a partir de qualquer thread e não apenas do thread que o obteve. Além disso, ao contrário de outros objetos expostos a partir de MAPI, este objeto é válido desde que o DLL seja carregado, pode ser reutilizado em sessões de inicialização e pode ser consumido antes ou depois de MAPIInitialize ter sido chamado. Devolve êxito ou falha através de um HRESULT padrão COM e atribui um parâmetro de saída a uma instância de IMAPIInitMonitor.

Interface: IMAPIInitMonitor

IFACEMETHODIMP_(BOOL) IsInitialized()

  • Devolve o estado atual da inicialização MAPI

Espera IFACEMETHODIMP(Tempo limite de DWORD)

  • Inicia uma chamada BLOCKING neste thread, que irá devolver quando o número especificado de milissegundos tiver decorrido ou o MAPI tiver sido inicializado. O INFINITE pode ser utilizado para uma espera infinita.

IFACEMETHODIMP BeginWait(Tempo limite DWORD, IMAPIWaitResult ppResult)

  • Inicie uma espera para que a inicialização MAPI ou o número especificado de milissegundos decorram. Esta ação devolve uma interface IMAPIWaitResult que deve ter "End" chamado para iniciar a espera. Isto permite que o autor da chamada controle que thread está bloqueado enquanto aguardamos.

Interface IMAPIWaitResult

Substituição de IFACEMETHODIMP End()

  • Chamado para iniciar a espera de bloqueio no thread no qual é chamado, não precisa de ser o mesmo thread chamado "BeginWait".

Conteúdo Revisto Anteriormente

O conteúdo foi adicionado em versões anteriores da Referência MAPI do Outlook para as seguintes funcionalidades:

  • Microsoft Outlook 2013 permite cenários de implementação não tradicionais, como lado a lado e Clique-e-Use. Estes cenários podem complicar a lógica utilizada para carregar a biblioteca MAPI adequada. Os programadores de MAPI têm agora a opção de ligar explicitamente às funções MAPI e podem optar por ligar explicitamente ao stub MAPI do cliente MAPI predefinido (por exemplo, Msmapi32.dll do Outlook) sem aceder à biblioteca MAPI e ao stub MAPI do Windows. Para obter mais informações sobre a ligação explícita em comparação com a ligação implícita, veja Ligar às Funções MAPI.

  • A Biblioteca MAPI Stub, publicada no MAPIStubLibrary no GitHub, fornece uma substituição pendente para Mapi32.lib que suporta a criação de aplicações MAPI de 32 bits e de 64 bits.

  • Suporte para o Microsoft Outlook de 64 bits – foram atualizados tópicos de referência para elementos de API aplicáveis para corresponder a novos ficheiros de cabeçalho que suportam o Outlook de 64 bits. Esses ficheiros de cabeçalho estão disponíveis em MAPIStubLibrary. Foi fornecido um novo exemplo de código em Verificar a Versão do Outlook para mostrar como marcar se a versão instalada do Outlook é de 64 bits Microsoft Outlook 2010 e foi revista para o Outlook 2013. Se a sua aplicação MAPI de 32 bits existente estiver a ser executada num sistema operativo de 64 bits com o Outlook de 64 bits instalado, terá de reconstruir a sua aplicação de 32 bits como uma aplicação de 64 bits. Para obter mais informações sobre o suporte MAPI para o Outlook de 64 bits, veja Building MAPI Applications on 32-Bit and 64-Bit Platforms (Criar Aplicações MAPI em Plataformas de 32 bits e de 64 bits).

  • Exemplo do Fornecedor do Arquivo de Mensagens — o Fornecedor de Arquivo PST Encapsulado de Exemplo tinha sido atualizado anteriormente para suportar a arquitetura de 64 bits. O tópico Initializing a Wrapped PST Store Provider (Inicializar um Fornecedor de Arquivo PST Encapsulado ) foi agora expandido para fornecer informações sobre os "Caminhos PST e Unicode Moldados".

  • Conclusão automática Stream — o tópico Cache de alcunhas, anteriormente o Formato de Ficheiro Nk2, foi atualizado para refletir as alterações no Outlook 2013 e no Outlook 2010. Informações como a lista de preenchimento automático, que é a lista de nomes que é apresentada nas caixas de edição Para, Cc e Bcc enquanto um utilizador está a compor um e-mail, são agora guardadas na conclusão automática Stream de uma mensagem no computador local, em vez de a guardar num ficheiro como no Outlook 2007.

    • Interagir com a Stream de Conclusão Automática

    • A carregar a Stream de Conclusão Automática

    • Guardar o Stream de Conclusão Automática

  • Suporte de encerramento rápido para clientes MAPI – os clientes MAPI podem agora iniciar um encerramento rápido e fazer com que o subsistema MAPI notifique os fornecedores carregados para minimizar a perda de dados do encerramento rápido. Foram adicionadas interfaces adicionais para o cliente e o fornecedor suportarem o encerramento rápido. Para obter mais informações sobre o encerramento rápido, veja Encerramento do Cliente na MAPI.

  • Stream estrutura para definições de campo para um item do Outlook — foi adicionada documentação para um fluxo binário para a propriedade PidLidPropertyDefinitionStream. Esta propriedade especifica definições de todos os campos personalizados e definições de enlace de dados para campos incorporados de um item do Outlook.

  • Substituição do Arquivo Pessoal — as seguintes interfaces e os respetivos métodos foram adicionados para suportar a substituição da política PSTDisableGrow dos fornecedores de ficheiros de Pastas Pessoais (PST):

    IPSTOVERRIDEREQ::IUnknown

    IPSTOVERRIDE1::IUnknown

  • Utilizar Múltiplas Contas do Exchange — foi adicionada documentação para a API do Livro de Endereços MAPI . Esta API foi melhorada para suportar várias contas do Exchange no Microsoft Outlook 2010 e agora inclui Microsoft Outlook 2013. Para resolve endereços corretamente com várias contas do Exchange, utilize as novas funções que têm um contexto de conta para que as chamadas para o livro de endereços pesquisem na conta do Exchange correta.

  • Formatos de Ficheiro MAPI – as informações de configuração mapi foram expandidas para explicar como pode utilizar caminhos em Registar Serviços e Fornecedores de Serviços no MapiSvc.inf.

  • Propriedades — As seguintes propriedades etiquetadas foram adicionadas para além da documentação de 38 outras propriedades etiquetadas e propriedades nomeadas que tinham sido adicionadas anteriormente:

  • Constantes MAPI – as Constantes MAPI consolidadas foram expandidas. Em versões anteriores, foram distribuídos em vários tópicos, mas agora são recolhidos num único tópico para facilitar a sua deteção e utilização. Também foram expandidos para fornecer uma cobertura mais extensa, incluindo as seguintes secções:

    • Definições para o Livro de Endereços do Exchange e Códigos de Erro do Arquivo de Mensagens

    • Definições para Quotas do Modo em Cache Exchange Server Caixa de Correio

Confira também

Introdução à Referência de MAPI do Outlook

MAPIStubLibrary