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 a documentação de vários novos recursos.

Novo conteúdo

O conteúdo foi adicionado para os seguintes recursos:

Monitor de Inicialização MAPI

  • Há momentos em que um aplicativo que consome MAPI pode querer saber quando a inicialização é concluída. Por exemplo, ele tem vários threads que poderiam inicializar MAPI ou em resposta à inicialização do MAPI que o aplicativo gostaria de executar algum trabalho, mas não deseja sempre girar a pilha MAPI. O monitor de inicialização fornece essa funcionalidade por meio de uma função (exportada de OLMAPI32.DLL) e algumas interfaces simples descritas abaixo.

HRESULT STDAPICALLTYPE CreateMapiInitializationMonitor(IMAPIInitMonitor ppInitMonitor)

  • Esse é o ponto de entrada exportado de OLMAPI32.DLL isso permite que o chamador recupere uma interface para consultar o estado de inicialização atual, configure um retorno de chamada para conclusão de inicialização ou bloqueie o thread atual até que seja concluído. O objeto retornado dessa API é reutilizável e com thread seguro e pode ser invocado de qualquer thread, não apenas thread que o recuperou. Além disso, ao contrário de outros objetos expostos do MAPI, esse objeto é válido desde que a DLL seja carregada, ele pode ser reutilizado em sessões de inicialização e pode ser consumido antes ou depois que MAPIInitialize for chamado. Retorna sucesso ou falha por meio de um HRESULT padrão com e atribui um parâmetro out a uma instância do IMAPIInitMonitor.

Interface: IMAPIInitMonitor

IFACEMETHODIMP_(BOOL) IsInitialized()

  • Retorna o estado atual da inicialização mapi

Espera IFACEMETHODIMP (tempo limite DWORD)

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

IFACEMETHODIMP BeginWait(tempo limite DWORD, IMAPIWaitResult ppResult)

  • Inicie uma espera pela inicialização mapi ou pelo número especificado de milissegundos a ser decorrido. Isso retorna uma interface IMAPIWaitResult que deve ter "End" chamado para iniciar a espera. Isso permite que o chamador controle qual thread está bloqueado enquanto aguardamos.

Interface IMAPIWaitResult

Substituição de End() IFACEMETHODIMP

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

Conteúdo revisado anteriormente

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

  • Microsoft Outlook 2013 permite cenários de implantação não tradicionais, como lado a lado e Clique para Executar. Esses cenários podem complicar a lógica usada para carregar a biblioteca MAPI adequada. Os desenvolvedores MAPI agora têm a opção de vincular explicitamente às funções MAPI e podem optar por vincular explicitamente ao stub MAPI do cliente MAPI padrão (por exemplo, Msmapi32.dll do Outlook) sem passar pela biblioteca MAPI e pelo stub mapi do Windows. Para obter mais informações sobre a vinculação explícita em comparação com a vinculação implícita, consulte Link to MAPI Functions.

  • Suporte para o Microsoft Outlook de 64 bits— Os tópicos de referência para elementos de API aplicáveis foram atualizados para corresponder a novos arquivos de cabeçalho que dão suporte ao Outlook de 64 bits. Esses arquivos de cabeçalho estão disponíveis como download no Outlook 2010: Mapi Header Files. Um novo exemplo de código foi fornecido 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 revisada para o Outlook 2013. Se o aplicativo MAPI existente de 32 bits estiver em execução em um sistema operacional de 64 bits com o Outlook de 64 bits instalado, você precisará recompilar seu aplicativo de 32 bits como um aplicativo de 64 bits. Para obter mais informações sobre o suporte mapi para o Outlook de 64 bits, confira Como criar aplicativos MAPI em plataformas de 32 bits e 64 bits.

  • Exemplo de provedor de repositório de mensagens — o provedor de loja PST encapsulado de exemplo já havia sido atualizado para dar suporte à arquitetura de 64 bits. O tópico Inicializando um Provedor de Repositório PST encapsulado foi expandido para fornecer informações sobre os "Caminhos de PST e Unicode encapsulados".

  • Autocompletar Stream— O tópico cache Apelido, anteriormente o Formato de Arquivo Nk2, foi atualizado para refletir as alterações no Outlook 2013 e no Outlook 2010. Informações como a lista de autocompletos, que é a lista de nomes exibidos nas caixas de edição To, Cc e Bcc enquanto um usuário está compondo um email, agora são salvas no Autocomplete Stream de uma mensagem no computador local, em vez de salvá-la em um arquivo como no Outlook 2007.

    • Interagindo com o Stream de autocompletar

    • Carregar o Stream de autocompletar

    • Salvando o Stream de autocompletar

  • Suporte de desligamento rápido para clientes MAPI — os clientes MAPI agora podem iniciar um desligamento rápido e fazer com que o subsistema MAPI notifique provedores carregados para minimizar a perda de dados do desligamento rápido. Interfaces adicionais foram adicionadas para que o cliente e o provedor dêem suporte ao desligamento rápido. Para obter mais informações sobre o desligamento rápido, consulte Desligamento do cliente no MAPI.

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

  • Substituição da Loja Pessoal — as seguintes interfaces e seus respectivos métodos foram adicionados para dar suporte à substituição da política PSTDisableGrow dos provedores de armazenamento de pastas pessoais (PST):

    IPSTOVERRIDEREQ::IUnknown

    IPSTOVERRIDE1::IUnknown

  • Usando várias contas do Exchange — a documentação da API do Catálogo de Endereços mapi foi adicionada. Essa API foi aprimorada para dar suporte a 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, use as novas funções que usam um contexto de conta para que as chamadas para o catálogo de endereços pesquisem a conta correta do Exchange.

  • Formatos de arquivo MAPI — as informações de configuração mapi foram expandidas para explicar como você pode usar caminhos no Registro de Serviços e Provedores de Serviços em MapiSvc.inf.

  • Propriedades – as seguintes propriedades marcadas foram adicionadas, além da documentação de outras 38 propriedades marcadas e propriedades nomeadas que haviam sido adicionadas anteriormente:

  • Constantes MAPI — As constantes mapi consolidadas foram expandidas. Em versões anteriores, elas foram distribuídas em vários tópicos, mas agora são coletadas em um único tópico para facilitar a descoberta e o uso. Eles também foram expandidos para fornecer uma cobertura mais ampla, incluindo as seguintes seções:

    • Definições para códigos de erro do Exchange Address Book e do Repositório de Mensagens

    • Definições para cotas de modo armazenado em cache da caixa de correio Exchange Server

Confira também

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

Codeplex