ID do artigo: 286408 - �ltima revis�o: quarta-feira, 19 de novembro de 2008 - Revis�o: 4.1

Descri��o das extens�es de cliente do Outlook e do Exchange

Clique aqui para exibir o artigo traduzido e o artigo original em ingl�s, lado a lado.

Exibir Aviso de Isen��o de Tradu��o Autom�tica

Exibir os produtos aos quais esse artigo se aplica.

Dica do SistemaEste artigo aplica-se a um sistema operativo diferente do que est� a utilizar. Foi desactivado o conte�do do artigo, que pode n�o ser relevante para si.

importante O white paper neste artigo foi originalmente escrito quando Microsoft Outlook 98 foi liberada e n�o tiver sido atualizado para refletir as informa��es mais recentes que podem se aplicar a vers�es posteriores do Outlook. Al�m disso, a lista de recursos adicionais no final do white paper n�o foi atualizada e pode estar desatualizada. Este artigo n�o ser� atualizado para corrigir desinforma��es desatualizadas ou incorretas.

Nesta p�gina

Expandir tudo | Recolher tudo

Sum�rio

Este artigo cont�m o texto "Microsoft Outlook e extens�es de cliente do Exchange" white paper, datado de mar�o de 1998, que estava dispon�vel anteriormente no site do MSDN.

Voltar para o in�cio

Mais Informa��es

Introdu��o

O Microsoft Outlook est� do Microsoft Office premier mensagens e colabora��o cliente para a Internet e o Microsoft Exchange Server.

O Outlook ajuda os usu�rios se comunicar com outras pessoas atrav�s do email, telefone, agendamento de grupo e software de confer�ncia Microsoft NetMeeting em tempo real. Permite que os usu�rios compartilhar informa��es com outras pessoas por meio de conectividade de Internet, Microsoft Exchange Server e formul�rios eletr�nicos e como um componente de solu��es colaborativas personalizadas. O Outlook tamb�m integra e organiza essa comunica��o e informa��es compartilhadas em um aplicativo.

A capacidade dos desenvolvedores estender o aplicativo Outlook bastante aprimora sua utilidade. Adicionar recursos personalizados, substituindo comportamentos padr�o, usando recursos existentes do Outlook e integra��o do Exchange existente as extens�es de cliente que seja poss�vel totalmente personalizar o potencial j� fabuloso do Outlook.

Este artigo lhe fornecer� uma breve introdu��o a MAPI (Messaging Application Programming Interface) e uma compreens�o de alto n�vel de sua fun��o em cen�rios que incluem o Microsoft Exchange Server. Seguir uma explica��o sobre os clientes Exchange e o Outlook � uma discuss�o sobre as extens�es de cliente e informa��es sobre a hospedagem de extens�es de cliente do Exchange pelo Outlook.

�til, mas n�o � necess�rio compreender neste artigo, � um conhecimento de n�vel intermedi�rio do C++ programa��o t�cnicas, COM (Component Object Model) e a interface de programa��o de aplicativo (API) do Microsoft Win32 orientada a objeto. Embora uma introdu��o ao MAPI est� inclu�da, � �til se voc� j� tiver alguma experi�ncia de desenvolvimento de mensagens.

Para criar uma extens�o de cliente, voc� deve completamente compreender e ser capaz de implementar as interfaces de extensibilidade do Microsoft Exchange IExchExt. Voc� deve ter acesso para fazer refer�ncia material para C++ programa��o t�cnicas, COM e MAPI orientada a objeto. Para gravar uma extens�o para Outlook, voc� deve ter um entendimento completo do modelo de objeto do Outlook.

Voltar para o in�cio

Informa��es de plano de fundo

Uma explica��o sobre as extens�es de cliente do Exchange deve come�ar com uma breve introdu��o a MAPI e como ele interage com o Exchange Server.

MAPI n�o � apenas uma biblioteca de fun��es, mas uma especifica��o para um subsistema de mensagens inteiro e todos os seus componentes intera��o. MAPI � projetado para atender aos tr�s requisitos princ�pio:

Interoperabilidade entre os componentes
Extensibilidade
Modularidade

MAPI foi criado para fornecer uma interface de n�vel de aplicativo padronizada que permitido mensagens componentes para se comunicar com sistemas de mensagens amplamente incompat�veis. MAPI simples ou MAPI vers�o 0, � uma biblioteca muito limitada de fun��es apenas 12 escritas pela Microsoft, que o cliente do Microsoft Mail para se comunicar com escrit�rios de postagem do Microsoft Mail ativado. A especifica��o de MAPI ou MAPI vers�o 1, estendida foi escrita pela Microsoft em colabora��o com mais de 100 fornecedores de software e, portanto, � uma especifica��o aberta que permite que sistemas compat�veis com MAPI para se comunicar livremente com outros sistemas compat�veis com MAPI. Ele substitui completamente a vers�o mais antiga.

A especifica��o de MAPI estendida inclui defini��es de v�rios componentes externos, descri��es de o que fazer, e uma lista das interfaces que elas exp�em. As interfaces entre os componentes n�o s�o APIs, mas COM interfaces. Componentes COM s�o vinculados juntos a aplicativos de formul�rio e podem ser estendidos para desenvolver extens�es de aplicativo personalizado. Todos os componentes MAPI usam ou implementam objetos MAPI, e todos os objetos MAPI s�o objetos COM.

MAPI n�o est� dispon�vel em todos os Microsoft baseados no Windows desktops. O Windows Messaging Subsystem (WMS) � a interface de usu�rio padr�o de MAPI. WMS originalmente era conhecido como o cliente do Exchange, mas foi renomeado para minimizar a confus�o. Como uma estrutura complicada, MAPI oferece v�rias perspectivas diferentes de arquiteturais:

O modelo de componente consiste em camadas de componentes que chamam uns aos outros por meio de media��o do MAPI32.dll, que � carregado como parte do processo de logon. Essa camada intermedi�ria atua como um agente entre aplicativos cliente, provedores de servi�os e MAPI propriamente dito.
O modelo de processo examina MAPI como uma cole��o de processos na �rea de trabalho.
O modelo de objeto � uma hierarquia de objetos que MAPI oferece a seus clientes da biblioteca de COM do sistema, acessando o objeto de sess�o de raiz, acessem assim o resto do modelo de objeto.

Microsoft Exchange Server adota padr�es da Internet e � um provedor de servi�os MAPI. Ele usa MAPI notifica��o para registrar eventos e inclui tr�s tipos de servi�os: Transporte de mensagem, armazenamento de mensagens e cat�logo de endere�os ou lista de endere�os. Quando uma nova mensagem � detectada no sistema, o provedor de transporte alerta o MAPI spooler, que processa a mensagem e o copia para o armazenamento de mensagens padr�o. O cat�logo de endere�os livremente fornece acesso de cliente a informa��es de diret�rio--uma lista de destinat�rios conhecidos que podem ser tanto usu�rios �nico ou listas de distribui��o.

Quando Microsoft Exchange Server envia uma mensagem, ele utiliza o subsistema MAPI para direcionar solicita��es de cliente para um ou mais provedores de servi�o de transporte. Microsoft Windows bibliotecas de v�nculo din�mico (DLLs) servem como drivers para cada provedor de transporte. Eles tamb�m fornecem a interface entre o MAPI spooler e o sistema de mensagens subjacente ou servi�os.

Exchange Server continuar� oferecer suporte a mais ampla matriz poss�vel de protocolos de rede (como RPC, IMAP4, POP3, NNTP, HTTP e assim por diante), e ele continuar� a oferecer suporte a MAPI como uma interface de programa��o.

Voltar para o in�cio

O que � o cliente do Exchange?

O Microsoft Exchange Client, fornecido com o Microsoft Exchange Server vers�o 4.0 por meio de vers�o 5.0, � um aplicativo (Exchng32.exe) que utiliza o Microsoft Exchange Server como seu provedor de servi�os. Ele oferece uma interface de usu�rio que fornece um m�todo para navega��o e manipula��o de caixa de entrada universal. H� uma tabela de hierarquia de pasta no painel � esquerda e uma lista de conte�do de pastas no painel � direita. O cliente do Exchange oferece ao usu�rio a oportunidade de solicitar exibi��es diferentes dessas tabelas, criar e enviar mensagens e usar muitos outros recursos. � limitado em seus recursos, mas como ele foi criado para flexibilidade e extensibilidade, permite aos desenvolvedores criar sistemas que refletem as necessidades dos seus usu�rios com mais precis�o.

O cliente do Exchange � suportado pelo, mas n�o est� inclu�do no Microsoft Exchange Server 5.5. Futuras altera��es a base de c�digo ser� limitadas �s modifica��es de engenharia solicitados pelo cliente, a corre��o r�pida para problemas que afetam o uso, interoperabilidade e/ou implanta��o.

Voltar para o in�cio

O que � o cliente Outlook?

O Outlook � o cliente totalmente otimizado para o Microsoft Exchange Server 5.0 e posterior. Lan�ado com a vers�o 5.0 do Microsoft Exchange Server e inclu�do no Microsoft Office 97, o Outlook 97 combina email, calend�rio e agendamento de recursos, contato e gerenciamento de tarefas, di�rio, aplicativos e personalizados com base em formul�rios em uma �nica interface. O Outlook 98 tamb�m inclui suporte completo, nativo para principal correio da Internet, not�cias e padr�es de diret�rio, como o IMAP4, LDAP, HTML, NNTP, MIME e S/MIME e tamb�m oferece suporte a esses padr�es de calend�rio e contato de Internet: iCalendar, vCard e vCalendar pesquisa de disponibilidade. O Outlook foi projetado para uso com a Internet protocolos (SMTP/POP3 e IMAP4), Microsoft Exchange Server ou qualquer outro sistema de comunica��o baseada em padr�es que oferece suporte a MAPI, incluindo correio de voz.

O Outlook permite o acesso completo a seus dados por outros aplicativos do Microsoft Office. Com sua biblioteca de objetos, voc� pode habilitar acesso por outros aplicativos para o Outlook email, compromissos, tarefas, itens de di�rio e anota��es. Biblioteca de objetos do Outlook, devido a sua integra��o com a fam�lia de produtos do Microsoft Office, permite o acesso program�tico a barras de comando do Office e o Assistente do Office. A biblioteca de objetos oferece suporte a separa��o de interface do usu�rio e dados; o objeto de aplicativo raiz lhe permite criar uma nova mensagem de email com uma �nica linha de c�digo. Por exemplo, no Microsoft Visual Basic Scripting Edition (VBScript):

Set newItem = Application.CreateItem(0)

objeto o aplicativo tamb�m � o ponto de entrada principal para o restante do armazenamento de dados. Usando o objeto MAPI NameSpace, voc� pode acessar todas as informa��es armazenadas no computador do Exchange Server.

Voc� pode estender a funcionalidade de formul�rios do Outlook usando o VBScript, que � um subconjunto do Visual Basic for Applications (VBA). O Outlook n�o hospeda VBA.

Voc� pode acessar um armazenamento de informa��es usando objetos do Outlook por meio de automa��o. Voc� fazer isso escrevendo o Visual Basic ou Visual Basic para c�digo de aplicativos no Visual, Microsoft Excel, Microsoft Access, Microsoft Word ou Microsoft PowerPoint.

O Outlook � uma plataforma de extensibilidade e solu��es de terceiros que permite aos desenvolvedores corporativos, provedores de solu��es e os desenvolvedores de software de terceiros criar aplicativos complementares que ampliam a funcionalidade do Outlook. O Outlook � o cliente de email principal para Microsoft Office e a atualiza��o para o cliente do Microsoft Exchange e Schedule +.

O Outlook 98 se baseia na fun��o do Outlook 97 como o cliente totalmente otimizada para o n�mero de crescimento r�pido de empresas que utilizam os recursos de email escalon�vel e avan�ados do Microsoft Exchange Server e seu grupo de calend�rio e colabora��o recursos, para seus neg�cios cr�ticos intranets. O Outlook 98 interopera com o Outlook 97 e atualizar de vers�es anteriores do Microsoft Mail, Microsoft Exchange Client ou Schedule +, sem a necessidade de um Microsoft Exchange Server.

Voltar para o in�cio

O que � um Exchange Client Extension?

Uma extens�o de cliente do Exchange � um objeto componente que implementa a interface IExchExt Exchange e em conformidade com o Microsoft Windows Component Object Model. Essa interface � definida no arquivo de cabe�alho Win32 Software Development Kit (SDK) Exchext.h e permite que o cliente carregar objetos de extens�o em todos os contextos. O cliente carrega o servidor de objetos e, em seguida, cria uma inst�ncia do objeto de extens�o para cada contexto extens�vel do cliente. Procure o t�tulo "Sobre extens�es de cliente" na MSDN Library, documenta��o plataforma SDK para obter mais informa��es sobre interface contextos.

As extens�es de cliente s�o criadas para aproveitar a capacidade do cliente existente. Essas capacidades inerentes s�o usadas e interfaces personalizadas s�o adicionadas pela extens�o. Em vez de desenvolver uma totalmente nova interface do usu�rio e servi�o de mensagens, a extens�o expande e utiliza recursos existentes.

Uma extens�o de cliente do Exchange difere de um servidor em processo COM padr�o no que ele n�o identifica sua classe com um CLSID e n�o registra o seu servidor sob a chave

HKEY_CLASSES_ROOT

do registro do sistema. Em vez disso, uma classe de extens�o identifica-se com uma seq��ncia de caracteres imprim�vel que serve para marca sua seq��ncia de registro sob a chave de registro

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Exchange\Client\Extensions

. O servidor de extens�o exporta um ponto de entrada que retorna uma nova inst�ncia de um objeto de extens�o. As interfaces adicionais de consultas de cliente desativado esse objeto conforme necess�rio.

H� quatro tipos principais de extens�es:

As extens�es de comando s�o as interfaces extens�o mais comuns. Eles Substituir comportamento existente ou adicione novos comandos de menus e barras de ferramentas do cliente usando a interface IExchExtCommands. Uma ferramenta de ortografia personalizados, ferramenta de formata��o de texto, comando de pasta p�blica ou comando de classe de mensagem pode ser implementado com uma extens�o de comando.
Extens�es de evento usam as interfaces de evento IExchExt para invocar o comportamento personalizado para manipular eventos como a chegada de novas mensagens; leitura, grava��o e envio de mensagens; leitura e grava��o de arquivos anexados e sele��o � alterada em uma janela. Substituindo o comportamento associado com determinados eventos, voc� pode transparente verificar anexos de mensagem de v�rus, ou compactar e descompactar mensagens com uma extens�o de evento.
Extens�es da folha de propriedade utilizar a interface IExchExtPropertySheets que permite que uma extens�o definir p�ginas adicionais em folhas de propriedades da cliente. Isso permite que usu�rios ou administradores para exibir ou editar propriedades de mensagem personalizada. Se seu aplicativo fornece um formul�rio personalizado com propriedades personalizadas, voc� pode exibir essas propriedades com uma extens�o de folha de propriedade.
Extens�es de crit�rios avan�ados s�o as interfaces de extens�o menos comuns. Usando a interface IExchExtAdvancedCriteria, voc� pode implementar suas pr�prias caixas de di�logo crit�rios avan�ados personalizado para ser usado ao procurar itens no armazenamento de informa��es. Voc� pode exibir uma caixa de di�logo crit�rios personalizados avan�ados que permite que os usu�rios especificar crit�rios para propriedades personalizadas com uma extens�o de crit�rios avan�ados.

Voltar para o in�cio

Como fazer um trabalho de extens�o cliente do Exchange no Outlook

Enquanto o Outlook reconhece, carrega e executa as extens�es que est�o em conformidade com as especifica��es para extens�es do Microsoft Exchange Client, existem m�todos para melhorar o desempenho e criar funcionalidades adicionais.

Uma entrada de registro de extens�o cliente � um valor de seq��ncia consiste em uma s�rie de ponto-e-v�rgula (;)-campos separados. A entrada � identificada com um nome de marca exclusivo que diferencia a entrada de outros valores sob a chave do Registro. A entrada consiste em seis campos. Os dois primeiros s�o necess�rios e identificam o n�mero de vers�o de entrada do Registro e o caminho para DLL de extens�o. Os campos pr�ximas quatro s�o opcionais, identifica o ponto de entrada ordinal, mapa de contexto, mapa de interface e o nome de servi�o de um provedor de servi�os que acompanha a extens�o de cliente. Se esses quatro campos estiverem vazios, o cliente fornece um valor padr�o adequada para cada campo vazio.

As extens�es de cliente exportar seus nomes e pontos de entrada nas suas entradas do registro

HKEY_LOCAL_MACHINE\Software\Microsoft\Exchange\Client\Extensions

Cada valor de seq��ncia dentro dessa chave constitui uma extens�o de cliente �nico. Quando o cliente for iniciado, ele l� o conte�do da chave para localizar todas as extens�es dispon�veis para o cliente.

Por padr�o, o cliente do Exchange l� a chave de registro da extens�o quando ele inicia e carrega todas as extens�es ter uma entrada nessa chave. Depois de carregar a biblioteca de cada extens�o, o cliente cria um objeto de extens�o de cada uma dessas bibliotecas para cada contexto de extensibilidade que encontrar, a menos que a biblioteca de extens�o foi especificado em seu mapa de contexto que n�o manipula um determinado contexto.

O Outlook usa o mesmo perfil e outras informa��es de configura��o, como o cliente do Exchange e pode usar todas as extens�es de cliente do Microsoft Exchange e formul�rios personalizados. Enquanto Outlook reconhece, carrega e executa extens�es que est�o em conformidade com a especifica��es para extens�es de cliente do Microsoft Exchange, voc� pode melhorar o desempenho da extens�o e aumentar sua funcionalidade em Outlook fornecendo um arquivo de configura��o de extens�o (ECF). Outlook usando um ECF, sabe antecipadamente os contextos em que uma extens�o precisa ser carregada, os comandos que a extens�o contribui, os m�dulos do Outlook para o qual se aplica a extens�o, e assim por diante. Isso permite ao Outlook atrasar a carregar a extens�o at� que seja necess�rio.

Sem um ECF, uma extens�o se registra no apenas o registro. Na entrada do Registro, as informa��es que pode especificar uma extens�o s�o limitadas a uma DLL, um ponto de entrada, um mapa de contexto bin�rio, um mapa de interface bin�rio e um provedor, se aplic�vel. No entanto, um ECF, permite que uma extens�o ao se registrar com dados muito mais completos e detalhados. Se um ECF � carregada para uma extens�o, entradas do Registro para a extens�o n�o ser�o usadas. Portanto, o ECF deve conter uma descri��o completa da extens�o. O ECF fornece informa��es textuais, usando o formato de arquivo INI padr�o. H� apenas um ECF por extens�o e somente uma extens�o por ECF. Para obter mais informa��es sobre como escrever um ECF, procure o t�pico "Outlook extens�o configura��o arquivo documento," na biblioteca MSDN, documenta��o do Microsoft Office Development.

O cliente Outlook l� que as informa��es do registro somente uma vez para uma extens�o e por motivos de desempenho, transfere para um cache interno. Esse cache interno � o arquivo extend.dat, localizado no diret�rio do Windows. O Outlook usa o arquivo extend.dat para registrar os caminhos para DLLs para todas as extens�es carregados no Outlook.

Na primeira vez que iniciar uma sess�o do Outlook ou qualquer momento ap�s uma extens�o estiver instalada, desinstalado ou atualizado, Extend.dat ir� ser reescrito com novos caminhos DLL. Extens�es exclu�das deixar�o de ter uma entrada no arquivo Extend.dat. Se extens�es indesejadas foram carregadas para o Outlook, voc� precisar� remov�-los usando o Gerenciador de adicionar manualmente. No Outlook 97, o Gerenciador de suplementos � acess�vel pelo menu Ferramentas clicando em Op��es , selecionando a guia Geral e clicando em Gerenciador de suplementos . Para remover uma extens�o, simplesmente Role para baixo at� localizar a extens�o, desmarque a caixa de sele��o ao lado para seu nome, clique em Remover e, em seguida, clique em OK . No Outlook 98, o Gerenciador de suplementos � acessado no menu ' Ferramentas ' clinking Op��es , em seguida, selecionando a guia outros , clicando em Op��es avan�adas e selecionando o Gestor de suplementos .

O cliente do Exchange n�o tem um arquivo Extend.dat, nem tem um Gerenciador de suplementos que usa ECFs.

Observa��o Uma das principais diferen�as entre os dois clientes � o fato de que o Outlook n�o permite uma extens�o acessar a interface do usu�rio do produto; isto �, para diretamente manipular HWNDs. Se a extens�o cliente do Exchange manipula as al�as de janela no Exchange Server, � prov�vel que essa extens�o n�o funcionar� corretamente no Outlook.

O m�todo de instala��o de extens�es difere no Exchange Server e o Outlook. No Exchange Server, voc� simplesmente adicionar uma nova entrada de registro para a extens�o em:

HKEY_LOCAL_MACHINE\Software\Microsoft\Exchange\Client\Extensions

No Outlook, em adi��o para a entrada de registro tradicional para a extens�o, voc� deve adicionar uma entrada chamada "Extens�o de instala��o do Outlook" (n�o localizar essa seq��ncia de caracteres). O valor deve ser:

4.0;Outxxx.dll;7;000000000000000;0000000000;OutXXX

Ele deve estar em:

HKEY_LOCAL_MACHINE\Software\Microsoft\Exchange\Client\Extensions

Sinais de entrada Outlook novas extens�es foram adicionadas ou removidas. O Outlook remover� essa entrada na pr�xima vez que ele � iniciado.

Observa��o No Windows Vista, Outlook n�o poder�o excluir esta chave executando sob uma conta de usu�rio normal. Portanto, ao instalar o Exchange Client Extension voc� deve verificar a exist�ncia da chave:

HKEY_CURRENT_USER\Software\Microsoft\Office\<version>\Outlook\Exchange Client Extension

e exclua-o. O Outlook n�o ser� carregado sua extens�o se esta chave existir.

Voltar para o in�cio

Como acessar o modelo de objeto do Outlook

Se voc� desejar acessar o modelo de objeto Outlook de dentro de uma extens�o, a Microsoft publica uma interface chamada IOutlookExtCallback para essa finalidade. O c�digo a seguir � o arquivo de cabe�alho:

#ifndef _OUTLOOK_H
#define _OUTLOOK_H

#if defined(WIN32) && !defined(MAC)

#ifndef __IOutlookExtCallback_FWD_DEFINED__
#define __IOutlookExtCallback_FWD_DEFINED__
typedef interface IOutlookExtCallback IOutlookExtCallback;
#endif /* __IOutlookExtCallback_FWD_DEFINED__ */ 

// Outlook defines this interface as an alternate to IExchExtCallback.
#ifndef __IOutlookExtCallback_INTERFACE_DEFINED__
#define __IOutlookExtCallback_INTERFACE_DEFINED__

EXTERN_C const IID IID_IOutlookExtCallback;

interface DECLSPEC_UUID("0006720D-0000-0000-C000-000000000046")
IOutlookExtCallback : public IUnknown
{
public:
   virtual HRESULT STDMETHODCALLTYPE GetObject(
      /* [out] */ IUnknown __RPC_FAR *__RPC_FAR *ppunk) = 0;
   virtual HRESULT STDMETHODCALLTYPE GetOfficeCharacter(
      /* [out] */ void __RPC_FAR *__RPC_FAR *ppmsotfc) = 0;
};

DEFINE_GUID(IID_IOutlookExtCallback,
0x0006720d,
0x0000,
0x0000,
0xc0, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x46);

#endif /* __IOutlookExtCallback_INTERFACE_DEFINED__ */ 
#endif // defined(WIN32) && !defined(MAC)
#endif // _OUTLOOK_H

in o arquivo de cabe�alho para a extens�o, voc� deve incluir o c�digo a seguir:

#ifndef __IOutlookExtCallback_INTERFACE_DEFINED__
#define __IOutlookExtCallback_INTERFACE_DEFINED__

EXTERN_C const IID IID_IOutlookExtCallback;

interface DECLSPEC_UUID("0006720D-0000-0000-C000-000000000046")
IOutlookExtCallback : public IUnknown
{
public:
   virtual HRESULT STDMETHODCALLTYPE GetObject(
      /* [out] */ IUnknown __RPC_FAR *__RPC_FAR *ppunk) = 0;
   virtual HRESULT STDMETHODCALLTYPE GetOfficeCharacter(
      /* [out] */ void __RPC_FAR *__RPC_FAR *ppmsotfc) = 0;
};

#endif /* __IOutlookExtCallback_INTERFACE_DEFINED__ */

O fragmento de c�digo a seguir obt�m acesso a um IDispatch para o contexto atual:

void GetRenDispatch(
   IExchExtCallback *lpeecb,
   IOutlookExtCallback **pprGetObj,
   IDispatch **ppdisp)
{
   IUnknown punk;

   lpeecb->QueryInterface(IID_IOutlookExtCallback,
      (void **) pprGetObj);

// If you are running Outlook, then prGetObj will not be NULL.
   if (*pprGetObj != NULL)
   {
      (*pprGetObj)->GetObject(&punk);
      if (punk != NULL)
      {
         punk->QueryInterface(IID_IDispatch, (void **) ppdisp);
      }
   }

   if ( punk != NULL )
      punk->Release();
}

esta fun��o retorna dois ponteiros o ponteiro para IOutlookExtCallback e o ponteiro para IDispatch. A primeira � retornada no caso do usu�rio deseja executar outras fun��es. A Microsoft fornece somente a fun��o GetOfficeCharacter. Se esta fun��o retorna NULL em ppdisp, a extens�o n�o est� sendo executado no Outlook. Este � um m�todo aceit�vel de determinar se o cliente que est� executando a extens�o � realmente Outlook e n�o o Exchange Client. O chamador � respons�vel por liberando os ponteiros retornados.

Voltar para o in�cio

Leitura recomendada

O recurso de melhor para aprender sobre o modelo de objeto do Outlook � o Microsoft Outlook Visual Basic Reference. Este arquivo de Ajuda est� dispon�vel como parte de adicionar ferramentas de desenvolvimento - in que tamb�m inclui o Pesquisador de objeto do Outlook e o depurador de scripts.

Tamb�m observe o seguinte:

O t�pico "Sobre as cliente extens�es," na biblioteca MSDN, documenta��o de Platform SDK.
O artigo "Automatizar e estendendo Microsoft Outlook," dispon�vel em:
http://www.microsoft.com/technet/archive/exchangeserver55/maintain/automate.mspx (http://www.microsoft.com/technet/archive/exchangeserver55/maintain/automate.mspx)
O t�pico "Outlook extens�o configura��o arquivo documento," no MSDN Library, documenta��o do Microsoft Office Development.
Criando aplicativos com o Microsoft Outlook 98, novo Edition. Krebs, Peter. Microsoft Press, 1998. ISBN: 1-57231-718-3.
Desenvolvendo aplicativos para o Microsoft Exchange com o C++. Goetter, Ben. Microsoft Press, 1996. ISBN: 1-57231-500-8.
Interior COM. Rogerson, Dale e. Microsoft Press, 1997. ISBN: 1-57231-349-8.
Interno de MAPI. Cruz de la Irving e Thaler, LES. Microsoft Press, 1996. ISBN: 1-57231-312-9.
Programa��o do Win32. Principiantes, M. de Joseph e Rector, Brent. Addison Wesley, c1997. S�rie: O avan�ados Windows s�rie. ISBN: 0-20163-492-9.

Observa��o Todos os livros dispon�veis na Microsoft Press podem ser ordenados do site da Microsoft Press na Web em:

http://mspress.microsoft.com/ (http://mspress.microsoft.com/)

Voltar para o in�cio

A informa��o contida neste artigo aplica-se a:

Microsoft Office Outlook 2003
Microsoft Outlook 2002 Standard Edition
Microsoft Outlook 2000
Microsoft Outlook 98 Standard Edition
Microsoft Outlook 97 Standard Edition

Voltar para o in�cio

kbmt kbemail kbexchange kbprogramming kbdswnet2003swept kbinfo KB286408 KbMtpt

Voltar para o in�cio

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: 286408� (http://support.microsoft.com/kb/286408/en-us/ )

Voltar para o in�cio

Outros Recursos

Outros Sites de Suporte

Comunidades

Obtenha Ajuda Agora

Entre em contato com um profissional de suporte por email, online, ou telefone.

Tradu��es deste artigo

United States (English)

This site in other countries/regions:

Descri��o das extens�es de cliente do Outlook e do Exchange

Nesta p�gina

Sum�rio

Mais Informa��es

Introdu��o

Informa��es de plano de fundo

O que � o cliente do Exchange?

O que � o cliente Outlook?

O que � um Exchange Client Extension?

Como fazer um trabalho de extens�o cliente do Exchange no Outlook

Como acessar o modelo de objeto do Outlook

Leitura recomendada

A informa��o contida neste artigo aplica-se a:

Palavras-chave:�

Outros Sites de Suporte

Comunidades

Obtenha Ajuda Agora

Tradu��es deste artigo

Centros de suporte relacionados