As diretrizes de suporte para desenvolvimento de mensagens do lado do cliente

Traduções deste artigo Traduções deste artigo
ID do artigo: 266353 - Exibir os produtos aos quais esse artigo se aplica.
Expandir tudo | Recolher tudo

Neste artigo

INTRODUÇÃO

Este artigo descreve o que é suportado e o que não é suportado quando você desenvolver soluções personalizadas que se integram com base em Microsoft mensagens produtos ou tecnologias Microsoft. Este artigo também contém a maioria das principais informações ficar atento quando você desenvolve com produtos e tecnologias Microsoft Microsoft. No entanto, este artigo não aborda todos os cenários. Contate o Atendimento de cliente Microsoft se você tiver dúvidas sobre se há suporte para uma solução específica.

Este artigo também descreve tecnologias específicas e cenários específicos para fornecer orientação para desenvolvedores.

Mais Informações

O termo "suportado" é usado para descrever se serviços de atendimento ao cliente da Microsoft ou Microsoft pode ajudá quando você tenta obter algo de uma maneira específica. Normalmente, o termo também é usado no contexto de se um grupo de produtos Microsoft potencialmente irá corrigir um problema para um determinado cenário.

Por causa da matriz grande de produtos, tecnologias e versões que requerem o teste, não é possível dizemos que todos os cenários foram criados ou testados. Portanto, recomendamos que você use as seguintes práticas recomendadas ao desenvolver soluções personalizadas:
  • Use apenas APIs que estão documentadas pela Microsoft. Isso evita o risco maior que sua solução não funcionará com uma versão mais recente de um produto ou juntamente com um service pack para um produto. Por exemplo, você pode usar o Microsoft Win32 API para manipular janelas de Microsoft Office Outlook. No entanto, não há suporte para a API do Win32. Algumas soluções podem ser suportadas no contexto de API do específico que você usar. No entanto, essas soluções geralmente não são suportadas no contexto de um Office aplicativo e quando você criar uma solução personalizada, usando esse aplicativo. Uma exceção seria um cenário documentadas pela Microsoft.
  • Evite a mistura de novas tecnologias e tecnologias mais antigas se fizer isso. Mistura de tecnologias mais antigas e novas tecnologias aumenta a possibilidade de que o cenário não foi testado e que o cenário não é suportado.
  • Quando você trabalha com aplicativos do Office, desenvolver a solução usando a versão mais antiga do Office que executa a solução.

Integração com propriedades do Outlook

O Outlook, Microsoft Exchange Server e outro produtos Microsoft store armazena dados em MAPI, como arquivos de pastas particulares (.pst), armazenamentos de caixas de correio do Exchange ou armazenamentos de pasta pública do Exchange. Embora alguns dos dados seja visível, vários outros dados não estiver visíveis e é armazenado por outros motivos.

Em alguns casos, há uma correspondência um-para-um entre o que você vê no Outlook e o que é armazenado no banco de dados MAPI subjacente. Caixa assunto da mensagem de email é um exemplo disso porque esta caixa corresponde à propriedade de MAPI PR_SUBJECT . Nesse caso, essa propriedade predates Outlook porque essa propriedade foi usada por clientes de email da Microsoft anteriores. Outras propriedades também tem uma correspondência um-para-um mas são específicas do Outlook. Por exemplo, endereço do site ?s um contato é armazenado em um MAPI específico chamado de propriedade.

Observação Para obter mais informações sobre propriedades nomeadas no Outlook, consulte a seção "informações específicas do MAPI para propriedades nomeadas".

Em alguns casos, Outlook pode usar várias propriedades MAPI para armazenar informações para uma finalidade específica ou Outlook pode armazenar várias partes de informações em uma propriedade. Em ambos os cenários, freqüentemente há não documentação explica como essas propriedades são implementadas ou como eles funcionam.

Alterar programaticamente as propriedades base envolve algum risco. As principais áreas incluem o seguinte:
  • O Outlook pode enfrentar um comportamento inesperado ou parar de responder quando algumas propriedades são alteradas.
  • Problemas podem ocorrer quando várias APIs são usadas para alterar dinamicamente algumas propriedades do Outlook enquanto o Outlook está em execução.
  • Versões diferentes do Outlook podem se conectar a MAPI mesmo armazena. Portanto, existe podem ser adicionados complexidade porque versões diferentes do Outlook podem interagir com propriedades relacionadas de maneiras diferentes.
Portanto, muitas propriedades MAPI que são usadas pelo Outlook não estão documentadas no nível do MAPI. O esquema MAPI que é usado é complexo e podem ser alterados com versões posteriores MAPI.

Portanto, recomendamos que você evite acessar esses dados de nível inferior diretamente e que você usar uma API de alto nível em vez disso, como a biblioteca de objetos do Outlook. Devido a esses fatores, Microsoft geralmente não oferece suporte explicando como ou por que as propriedades base são implementadas.

Também é importante diferenciar entre propriedades de leitura e gravação de propriedades. Há suporte para ler programaticamente propriedades MAPI usando APIs como MAPI estendido, WebDAV ou o objeto PropertyAccessor no modelo de objeto do Microsoft Office Outlook 2007. No entanto, gravar essas propriedades não é suportado devido o potencial para problemas de corrupção de dados ou para outros problemas que outros MAPI clientes podem ter quando eles usam os dados modificados.

Informações específicas de MAPI para propriedades nomeadas

MAPI fornece um recurso para atribuir nomes a determinadas propriedades, para mapear esses nomes para identificadores exclusivos e para fazer esse mapeamento persistente. O Outlook grava muitos campos específicas do Outlook para essas propriedades utilizam identificadores no intervalo de 8000 FFFE nomeadas. Normalmente, o modelo de objeto do Microsoft Outlook é o único método suportado de alterar essas propriedades nomeadas. Normalmente, não há suporte para alterar essas propriedades usando MAPI ou usando o CDO (Collaboration Data Objects).

Propriedades nomeadas são identificadas por um nome e por um GUID para um conjunto de propriedades. O nome pode ser um número ou uma seqüência de caracteres. Essas propriedades são encontram manipuladas através da função IMAPIProp::GetIDsFromNames e a função IMAPIProp::GetNamesFromIDs . O GUID e o nome são passados para a função GetIDsFromNames para obter uma identificação de propriedade que é válida para a sessão MAPI atual. Como essa identificação de propriedade pode variar de um computador para outro, a maneira somente consistente de acessar uma propriedade nomeada é saber seu conjunto de propriedade e seu nome.

Em geral, propriedades nomeadas são usadas por clientes do Outlook como uma maneira de adicionar informações extras a uma mensagem que é usada somente por que o cliente. Portanto, a maioria das nomeado propriedades usados por clientes do Outlook não está documentada. A única maneira para os quais há suporte para obter essas propriedades é por meio do modelo de objeto do Outlook.

Comum denominada propriedades que são usadas pelo Outlook

A tabela a seguir descreve comum denominada propriedades que são usadas pelo Outlook.
Recolher esta tabelaExpandir esta tabela
tipo de item (classe de mensagem) Resumo da capacidade de suporte
Mensagens (IPM.Note)As mensagens são nativas para MAPI. O Outlook manter algumas propriedades nomeadas nesses itens.
Itens de contato (IPM.Contact)Contatos não são nativos para MAPI. Porque contatos se parecer com entradas de catálogo de endereços, algumas marcas de entrada de endereço são válidas. A maioria das propriedades de contatos são propriedades nomeadas.
Itens de tarefa (IPM.tarefa)Tarefas não são nativas para MAPI. A maioria das propriedades da tarefa são propriedades nomeadas.
Itens de compromisso (IPM.Appointment)Compromissos não estão nativos para MAPI, mas nativos para o CDO. A maioria das propriedades de compromisso são propriedades nomeadas. Algumas propriedades de compromisso são expostas através do objeto CDO Item de compromisso .
Itens de diário (IPM.atividade)Diários não são nativos para MAPI. A maioria das propriedades de diário são propriedades nomeadas.
Itens de anotação (IPM.NotasAutoAdesivas)Notas auto-adesivas não são nativas para MAPI. A maioria das propriedades de auto-adesiva são propriedades nomeadas.
Além as propriedades que são nativas para MAPI, campos definidos pelo usuário em formulários personalizados do Outlook são suporte por meio de MAPI, por meio de CDO, por meio de WebDAV e por meio do modelo de objeto do Outlook. Esses campos usam PS_PUBLIC_STRINGS propriedade como a propriedade definida identificador e o nome do campo como o nome da propriedade. Para obter mais informações sobre cenários de suporte para dados com base em WebDAV e baseada em MAPI de dados, clique no número abaixo para ler o artigo na Base de dados de Conhecimento da Microsoft:
920134Suporte disponíveis para aplicativos que usam o protocolo WebDAV para acessar o Exchange 2000 Server ou Exchange Server 2003
A API de integração do Outlook fornece documentação adicional para integração com o Outlook em cenários específicos. Para consultar essa documentação, visite o seguinte site:
http://msdn2.microsoft.com/en-us/library/aa193231(office.11).aspx
Além disso, as informações a seguir estão documentadas para o Outlook 2007 e estão programadas para ser incluído na API de integração do Outlook em uma data posterior. Para obter mais informações, clique nos números abaixo para ler os artigos na Base de dados de Conhecimento da Microsoft:
919198Suporte de indexação baseado em notificação para provedores de armazenamento no Outlook 2007
919199Como usar a API IAttachmentSecurity para verificar se um anexo é considerado para ser bloqueados no Outlook
Para obter mais informações, visite os seguintes sites:
O Outlook 2007 documentação - anexos bloqueados
http://blogs.msdn.com/stephen_griffin/archive/2006/05/09/593585.aspx

O Outlook 2007 documentação - notificação com suporte a indexação
http://blogs.msdn.com/stephen_griffin/archive/2006/05/10/594641.aspx

Microsoft Office Outlook 2003 Service Pack 1 (SP1) ou versões posteriores

Para obter mais informações, clique nos números abaixo para ler os artigos na Base de dados de Conhecimento da Microsoft:
912239Como usar a propriedade MAPI dispidHeaderItem para identificar o estado de uma mensagem que você receber no Outlook 2003
912238Como usar o MAPI para gerenciar mensagens em um arquivo .pst quando você estiver usando o Outlook 2003 para baixar mensagens de um servidor IMAP
912237Como usar propriedades nomeadas para relacionar as entradas do contato catálogo de endereços para mensagens de email, endereços de email e anexos de imagem no Outlook 2003
915314Informações sobre duas novo chamado definições de propriedade que podem controlar como uma mensagem é processada pelo Office Outlook 2003 quando os usuários respondem à mensagem
Para obter mais informações, visite os seguintes sites:
Outlook nova documentação parte 5 - formulários individuais
http://blogs.msdn.com/stephen_griffin/archive/2005/12/29/507991.aspx

API de integração do Outlook 2003 quebradas PST documentos e exemplo
http://blogs.msdn.com/stephen_griffin/archive/2005/09/28/Outlook-2003-Integration-API-Wrapped-PST-Docs-and-Sample.aspx

APIs que são suportadas no código gerenciado

MAPI foi originalmente projetado e desenvolvido originalmente nos anos 80 atrasado. Portanto, MAPI predates código gerenciado no Microsoft .NET Framework. Nós não fornecem invólucros gerenciados para MAPI e desencorajar você de usar wrappers de terceiros. Isso ocorre porque soluções podem parecer trabalhar em um ambiente de teste, mas que é relacionados a gerenciamento de memória pode ocorrer quando um aplicativo é implantado em um ambiente de produção e é exposto a cenários de escalabilidade do mundo real.

A tabela a seguir resume a diretiva de suporte para APIs do Outlook no ambiente do .NET Framework.
Recolher esta tabelaExpandir esta tabela
API nome da DLL diretiva de suporte ao código gerenciado
Modelo de objeto do OutlookNão aplicávelSuporte, usando um assembly de interoperabilidade COM
Collaboration Data Objects (CDO) 1.2 xCDO.dllNão há suporte para
MAPI (Extended MAPI ou MAPI simples)Mapi32.dll ou Msmapi32.dllNão há suporte para
Serviços Web do Exchange Server 2007Não aplicávelSuporte para
WebDAV (Exchange 2000 Server e Exchange Server 2003, preterido no Exchange Server 2007)Não aplicávelSuporte para
Para obter mais informações sobre as diretivas de suporte para outras APIs de mensagens em código gerenciado, clique no número abaixo para ler o artigo na Base de dados de Conhecimento da Microsoft:
813349Política de suporte para APIs do Microsoft Exchange com aplicativos do .NET Framework

Os controles de usuário do .NET Framework

Não há suporte para os controles de usuário do .NET Framework no Outlook 2003, em versões anteriores do Outlook ou em regiões de formulário personalizado do Outlook 2007. Para obter mais informações sobre o suporte para esses controles, clique no número abaixo para ler o artigo na Base de dados de Conhecimento da Microsoft:
897863Descrição da capacidade de suporte do WinForms controles em aplicativos não gerenciados

Formulários personalizados e cenários HTTP para o Outlook 2003 e para versões anteriores do Outlook

No Outlook, não há suporte para formulários personalizados do Outlook para uso com serviços de email baseado em HTTP, como o Microsoft Hotmail. O Outlook não impede você de usar recursos de formulário personalizado se você estiver usando um serviço de email baseado em HTTP. No entanto, alguns recursos não funcionam corretamente. Os recursos não funcionam corretamente porque as mensagens de email baseado em HTTP são armazenadas em um estado somente leitura no servidor. Portanto, recomendamos que você não usar formulários personalizados do Outlook se você estiver usando um serviço de email baseado em HTTP.

Controlos MAPI do Microsoft Visual Basic 6.0

Controlos MAPI do Visual Basic 6.0 são baseados em Simple MAPI e não são testados ou suporte para iniciar no Outlook 2007. Recomendamos que você usar uma API mais recente para soluções de e-mail.

Observação O suporte padrão para o Visual Basic 6.0 expirou.

Chamadas de mensagens comuns

CMC (Common Messaging Calls) não tem suporte após a atualização a versão da segurança de email do Outlook em junho de 2000.

Intercâmbio dinâmico de dados (DDE)

Ao contrário de outros aplicativos do Office, Outlook não oferece suporte a intercâmbio dinâmico de dados (DDE) como uma forma de programaticamente se comunicar com o Outlook.

Microsoft Outlook Express (Microsoft Windows XP)

Por um longo tempo, a API com suporte somente para o Outlook Express foi MAPI simples. MAPI simples é um conjunto de funções e as estruturas de dados relacionados que você pode usar para adicionar funcionalidade de mensagens para aplicativos personalizados. As funções MAPI simples não estão disponíveis nas versões para o C, C++ e Visual Basic.

A documentação para Simple MAPI é fornecida no SDK do Microsoft Exchange. Para consultar essa documentação, visite o seguinte site:
http://msdn.microsoft.com/en-us/library/aa142548(EXCHG.65).aspx
O Outlook Express usa o catálogo de endereços do Windows (WAB). Para obter mais informações sobre o catálogo do Windows, visite o seguinte site:
http://msdn.microsoft.com/en-us/library/ms629361.aspx

Windows Mail no Windows Vista

No Windows Vista, Windows Mail é a substituição para o Outlook Express. Para documentação do desenvolvedor, visite o seguinte site da Microsoft:
http://msdn.microsoft.com/en-us/library/ms709546.aspx
APIs que estão disponíveis para o Outlook Express 6.0 também estão incluídas nesta documentação.

Windows Live APIs e SDKs

Para obter mais informações sobre as APIs relacionadas a email e sobre as opções de suporte para Windows Live, visite o seguinte site:
http://dev.live.com/
Suporte de cliente do Microsoft atualmente não oferece suporte para essas APIs.

Referências

Para obter mais informações sobre propriedades nomeadas, visite o seguinte site:
http://msdn2.microsoft.com/en-us/library/ms529055.aspx

Propriedades

ID do artigo: 266353 - Última revisão: sexta-feira, 30 de março de 2007 - Revisão: 5.5
A informação contida neste artigo aplica-se a:
  • Microsoft Messaging Application Programming Interface
  • Microsoft Office Outlook 2007
  • Microsoft Office Outlook 2003
  • Microsoft Outlook 2002 Standard Edition
  • Microsoft Outlook 2000
  • Microsoft Outlook 98 Standard Edition
  • Microsoft Outlook 97 Standard Edition
  • Microsoft Collaboration Data Objects 1.21
  • Microsoft Outlook Express 5.0
  • Microsoft Outlook Express 5.5
  • Microsoft Outlook Express 6.0
Palavras-chave: 
kbmt kbinfo kbmsg kboutlookobj KB266353 KbMtpt
Tradução automática
IMPORTANTE: Este artigo foi traduzido por um sistema de tradução automática (também designado por Machine Translation ou MT), não tendo sido portanto traduzido ou revisto por pessoas. A Microsoft possui artigos traduzidos por aplicações (MT) e artigos traduzidos por tradutores profissionais, com o objetivo de oferecer em português a totalidade dos artigos existentes na base de dados de suporte. No entanto, a tradução automática não é sempre perfeita, podendo conter erros de vocabulário, sintaxe ou gramática. A Microsoft não é responsável por incoerências, erros ou prejuízos ocorridos em decorrência da utilização dos artigos MT por parte dos nossos clientes. A Microsoft realiza atualizações freqüentes ao software de tradução automática (MT). Obrigado.
Clique aqui para ver a versão em Inglês deste artigo: 266353

Submeter comentários

 

Contact us for more help

Contact us for more help
Connect with Answer Desk for expert help.
Get more support from smallbusiness.support.microsoft.com