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.

Ver isen��o de responsabilidades para tradu��o autom�tica

Ver produtos para os quais este 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 A documenta��o t�cnica neste artigo foi escrita originalmente quando o Microsoft Outlook 98 foi lan�ada e n�o foi actualizado para reflectir as informa��es mais recentes que podem se aplicam a vers�es posteriores do Outlook. Al�m disso, a lista de recursos adicionais no fim da documenta��o t�cnica fornecido n�o foi actualizada e poder� estar desactualizada. Este artigo n�o ser� actualizado para corrigir misinformation desactualizado ou incorrecto.

Nesta p�gina

Expandir tudo | Reduzir tudo

Sum�rio

Este artigo cont�m o texto do papel em branco "Microsoft Outlook e Exchange Client Extensions", datada de Mar�o de 1998, que estava anteriormente dispon�vel no Web site da MSDN.

Voltar ao topo

Mais Informa��o

Introdu��o

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

O Outlook ajuda os utilizadores comunicar com outros utilizadores atrav�s de correio electr�nico, telefone, compromissos de grupo e software de confer�ncia em tempo real do Microsoft NetMeeting. Permite aos utilizadores partilhar informa��es com outros atrav�s da liga��o � Internet, Microsoft Exchange Server e formul�rios electr�nicos e como um componente de solu��es colaborativas personalizadas. O Outlook tamb�m integra e organiza todos os esta comunica��o e informa��es partilhadas numa aplica��o.

Expandir a aplica��o Outlook bastante a capacidade de programadores melhora a respectiva utilidade. Adicionar funcionalidades personalizadas, substituindo os comportamentos predefinidos, utilizando funcionalidades do Outlook existentes e integrar Exchange existente as extens�es de cliente permitem totalmente personalizar o potencial j� festa do Outlook.

Este artigo fornecer� uma breve introdu��o para a MAPI Messaging Application Programming Interface () e uma compreens�o de alto n�vel da respectiva fun��o nos cen�rios que incluem o Microsoft Exchange Server. Ap�s uma explica��o dos clientes Exchange e 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 interm�dio do C++ programa��o t�cnicas, COM (Component Object Model) e a interface de programa��o de aplica��es (API) Microsoft Win32 orientada para objectos. Embora uma introdu��o � MAPI est� inclu�da, � �til se tiver alguma experi�ncia de programa��o de mensagens.

Para criar uma extens�o de cliente, deve cuidadosamente de compreender e ser capaz de implementar as interfaces de extensibilidade IExchExt do Microsoft Exchange. Dever� ter acesso a material para o C++ programa��o t�cnicas, COM e MAPI orientada para objectos de refer�ncia. Para escrever uma extens�o para o Outlook, dever� ter um conhecimento aprofundado do modelo de objectos do Outlook.

Voltar ao topo

Informa��es de fundo

Uma explica��o das extens�es de cliente do Exchange tem de come�ar com uma breve introdu��o a MAPI e como interage com o Exchange Server.

MAPI n�o � apenas uma biblioteca de fun��es, mas uma especifica��o para um subsistema mensagens completo e todos os seus componentes interacting. MAPI � concebida para cumprir tr�s requisitos princ�pio:

Interoperabilidade entre componentes
Extensibilidade
Modularidade

MAPI foi criado para fornecer uma interface n�vel da aplica��o padr�o que permitido mensagens componentes para comunicar com sistemas de mensagens amplamente incompat�veis. MAPI simples ou MAPI vers�o 0, � uma biblioteca muito limitada de fun��es apenas 12 escrito pela Microsoft, que o cliente do Microsoft Mail para comunicar com o Microsoft Mail post offices activado. A especifica��o de MAPI ou MAPI vers�o 1, expandida foi escrita pela Microsoft em colabora��o com fabricantes de software mais de 100 e assim, � uma especifica��o aberta que permite a sistemas compat�veis com MAPI comunicar livremente com outros sistemas compat�vel com MAPI. Completamente substitui a vers�o mais antiga.

A especifica��o de MAPI expandida inclui defini��es de v�rios componentes externos, descri��es das quais fazem, e uma lista das interfaces expor. As interfaces entre componentes n�o s�o APIs, mas COM interfaces. COM componentes associados em conjunto a aplica��es de formul�rio e podem ser expandidos para desenvolver extens�es de aplica��o personalizada. Todos os componentes MAPI utilizam ou implementam objectos MAPI e todos os objectos MAPI s�o COM objectos.

MAPI est� dispon�vel em todos os computadores baseados no Windows do Microsoft. O Windows Messaging Subsystem (WMS) � a interface de utilizador padr�o MAPI. WMS originalmente foi referido como o cliente do Exchange, mas o nome foi mudado para minimizar a confus�o. Como uma estrutura complexa, MAPI oferece v�rias perspectivas arquitecturais diferentes:

O modelo de componente consiste em camadas de componentes que chamam entre si atrav�s de Media��o do ficheiro Mapi32.dll, que � carregado como parte do processo de in�cio de sess�o. Esta camada intermedi�ria actua como um corretor entre o aplicativos de clientes, fornecedores de servi�os e MAPI propriamente dito.
O modelo de processo examina MAPI como um conjunto de processos no ambiente de trabalho.
O modelo de objecto � uma hierarquia de objectos que MAPI oferece aos clientes da biblioteca COM sistema acedendo o objecto de sess�o de raiz, assim aceder ao resto do modelo de objecto.

Microsoft Exchange Server aborda as normas da Internet e � um fornecedor de servi�os MAPI. Utiliza a notifica��o de MAPI para registar eventos e inclui tr�s tipos de servi�os: transporte de mensagens, o arquivo de mensagens e livro de endere�os ou lista de endere�os. Quando uma nova mensagem � detectada no sistema, o fornecedor de transporte alerta o spooler MAPI, que processa a mensagem e copia-o para o arquivo de mensagens predefinido. O livro de endere�os livremente proporciona acesso de cliente �s informa��es de direct�rio--uma lista de destinat�rios conhecidos que poder�o ser utilizadores �nico ou ou listas de distribui��o.

Quando Microsoft Exchange Server envia uma mensagem, depende o subsistema MAPI para encaminhar pedidos de cliente para um ou mais fornecedores de servi�o de transporte. Microsoft Windows bibliotecas de liga��o din�mica (DLL) servem de controladores para cada fornecedor de transporte. Tamb�m fornecem a interface entre o spool de MAPI e o sistema de mensagens subjacente ou servi�os.

Exchange Server ir� continuar suportar a matriz de poss�vel maior de protocolos de rede (como o RPC IMAP4, POP3, NNTP, HTTP e assim sucessivamente) e continuar� a suportar MAPI como uma interface de programa��o.

Voltar ao topo

O que � o cliente do Exchange?

O cliente do Microsoft Exchange, inclu�do no Microsoft Exchange Server vers�o 4.0, a vers�o 5.0, � uma aplica��o (Exchng32.exe) que utiliza o Microsoft Exchange Server como fornecedor de servi�o. Fornece uma interface de utilizador que fornece um m�todo para navegar e manipular a pasta a receber universal. Existe uma tabela de hierarquia de pastas no painel da esquerda e uma lista de conte�do de pastas no painel da direita. O cliente do Exchange oferece ao utilizador uma oportunidade para pedir diferentes vistas destas tabelas, criar e enviar mensagens e utilizar muitas outras funcionalidades. � limitado em suas capacidades, mas uma vez que foi concebido para extensibilidade e flexibilidade, permite aos programadores criar sistemas reflectirem com mais exactid�o as necessidades dos respectivos utilizadores.

O cliente do Exchange � suportado pelo, mas n�o est� inclu�do no Microsoft Exchange Server 5.5. Futuras altera��es � base de c�digo ser� limitadas a modifica��es de engenharia quick-fix, pedido de cliente para problemas que afectam a utiliza��o, interoperabilidade e/ou implementa��o.

Voltar ao topo

O que � o cliente do Outlook?

O Outlook � o cliente totalmente optimizado para o Microsoft Exchange Server 5.0 e vers�es posteriores. Publicado com vers�o 5.0 do Microsoft Exchange Server e inclu�do no Microsoft Office 97, o Outlook 97 combina correio electr�nico, calend�rio e agendar as funcionalidades, contacto e gest�o de tarefas, registo em di�rio, aplica��es e personalizadas baseada em formul�rios numa �nica interface. O Outlook 98 tamb�m inclui suporte completo e nativo para correio da Internet principal, not�cias e padr�es de direct�rio, tais como IMAP4, LDAP, HTML, NNTP, MIME e S/MIME e tamb�m suporta estes padr�es de calend�rio e contacto Internet: iCalendar, vCard e vCalendar pesquisa de disponibilidade. O Outlook foi concebido para utiliza��o com Internet protocolos (SMTP/POP3 e IMAP4), Microsoft Exchange Server ou qualquer outro sistema baseado em normas de comunica��o que suporta MAPI, incluindo correio de voz.

O Outlook permite o acesso completo aos respectivos dados por outras aplica��es do Microsoft Office. Com a biblioteca de objectos, pode activar o acesso por outras aplica��es para correio electr�nico, compromissos, tarefas, itens de di�rio e notas de Outlook. A biblioteca de objectos do Outlook, devido a integra��o com a fam�lia de produto do Microsoft Office, permite o acesso program�tico a barras de comandos do Office e o Assistente do Office. A biblioteca de objectos suporta a separa��o dos dados e interface de utilizador; o objecto de aplica��o raiz permite-lhe criar uma nova mensagem de correio electr�nico com uma �nica linha de c�digo. Por exemplo, no Microsoft Visual Basic Scripting Edition (VBScript):

Set newItem = Application.CreateItem(0)

aplica��o o objecto tamb�m � o ponto de entrada principal para o resto do arquivo de dados. Utilizar o objecto MAPI espa�o de nomes, pode aceder a todas as informa��es armazenadas no computador com o Exchange Server.

Pode expandir a funcionalidade de formul�rios do Outlook utilizando o VBScript, que � um subconjunto do Visual Basic for Applications (VBA). O Outlook n�o aloja VBA.

Pode aceder a um arquivo de informa��es utilizando objectos do Outlook atrav�s de automatiza��o. Para tal, escrever o Visual Basic ou Visual Basic para aplica��es de c�digo no Visual, o Microsoft Excel, o Microsoft Access, Microsoft Word ou Microsoft PowerPoint.

O Outlook � uma plataforma para extensibilidade e solu��es de outros fabricantes que permite que os programadores empresariais, fornecedores de solu��es e programadores de software de outros fabricantes criar aplica��es suplemento que expandem a funcionalidade do Outlook. O Outlook � o cliente de correio electr�nico principal para Microsoft Office e a actualiza��o para o cliente do Microsoft Exchange e o Schedule +.

O Outlook 98 cria na fun��o do Outlook 97 como o cliente totalmente optimizado para o n�mero em r�pido crescimento das empresas dependem as capacidades de correio electr�nico dimension�vel e avan�ados do Microsoft Exchange Server e respectivas grupo calend�rio funcionalidades e colabora��o, para as intranets empresariais essenciais. O Outlook 98 interage com o Outlook 97 e vers�es anteriores do Microsoft Mail, cliente do Microsoft Exchange ou Schedule +, sem ser necess�rio um Microsoft Exchange Server actualizar.

Voltar ao topo

O que � uma extens�o de cliente do Exchange?

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

As extens�es de cliente s�o criadas para tirar partido das capacidades existentes do cliente. Estas capacidades inerentes s�o utilizadas e interfaces personalizadas s�o adicionadas pela extens�o. Em vez de desenvolver uma interface de utilizador totalmente nova e servi�o de mensagens, a extens�o � expandida e utiliza funcionalidades existentes.

Uma extens�o de cliente do Exchange difere de um servidor em execu��o COM padr�o em que n�o identifica a classe com um controlo CLSID e n�o regista o respectivo servidor sob a chave

HKEY_CLASSES_ROOT

do registo do sistema. Em vez disso, uma classe de extens�o identifica-se com uma cadeia de impressa que funciona para a cadeia de registo na chave de registo

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Exchange\Client\Extensions

de c�digo. O servidor de extens�o exporta um ponto de entrada que devolve uma nova inst�ncia do objecto de extens�o. As consultas de cliente adicionais interfaces desactivar este objecto conforme necess�rio.

Existem quatro tipos principais de extens�es:

As extens�es de comando s�o as interfaces de extens�o mais comuns. Podem substituir comportamento existente ou adicionar novos comandos a menus e barras de ferramentas do cliente utilizando a interface IExchExtCommands. Uma ferramenta de ortografia personalizado, ferramenta formata��o de texto, comandos de pasta p�blica ou comando de classe da mensagem pode ser implementado com uma extens�o de comando.
Extens�es de evento utilizam as interfaces de evento IExchExt para invocar o comportamento personalizado para processar eventos, tais como a chegada de novas mensagens; leitura, escrita e enviar mensagens; ler e escrever ficheiros anexados e selec��o � alterada numa janela. Por substituir o comportamento associado a determinados eventos, pode forma transparente verificar anexos de mensagem de v�rus, ou comprimir e descomprimir mensagens com uma extens�o de evento.
Extens�es de folha de propriedade utilizam a interface IExchExtPropertySheets que permite uma extens�o definir p�ginas adicionais nas folhas de propriedades de cliente. Isto permite que utilizadores ou administradores para ver ou editar propriedades de mensagem personalizada. Se a aplica��o proporciona uma forma personalizada com propriedades personalizadas, pode visualizar as propriedades com uma extens�o de folha de propriedades.
As extens�es de crit�rios avan�ados s�o as interfaces de extens�o menos comuns. Utilizando a interface de IExchExtAdvancedCriteria, pode implementar as suas pr�prias caixas de di�logo personalizada crit�rios avan�ados a ser utilizado quando procurar itens no arquivo de informa��es. Pode apresentar uma caixa de di�logo personalizada crit�rios avan�ados que permite aos utilizadores especificar crit�rios de procura para propriedades personalizadas com uma extens�o de crit�rios avan�ados.

Voltar ao topo

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

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

Uma entrada de registo de extens�o de cliente � um valor de cadeia de uma s�rie de ponto e v�rgula (;)-campos separados. A entrada � identificada com um nome de c�digo exclusivo que diferencia a entrada de outros valores sob a chave de registo. A entrada � composto por seis campos. Os dois primeiros s�o necess�rios e identificam o n�mero de vers�o de entrada de registo e o caminho para DLL a extens�o. Em seguida quatro campos s�o opcionais, que identifica o ponto de entrada ordinal, mapa de contexto, mapa de interface e nome do servi�o de um fornecedor de servi�os que acompanha a extens�o de cliente. Se estes quatro campos vazios, o cliente fornece um valor adequado para cada campo vazio.

As extens�es de cliente exportar os nomes e pontos de entrada nas respectivas entradas registo

HKEY_LOCAL_MACHINE\Software\Microsoft\Exchange\Client\Extensions

Cada valor de cadeia dentro desta chave constitui uma extens�o de cliente individual. Quando o cliente � iniciado, l� o conte�do da chave para localizar todas as extens�es dispon�veis para o cliente.

Por predefini��o, o cliente do Exchange l� a chave de registo de extens�o quando � iniciado e carrega todas as extens�es a exist�ncia de uma entrada nesta chave. Ap�s carregar cada biblioteca de extens�o, o cliente cria um objecto da extens�o de cada uma destas bibliotecas para cada contexto de extensibilidade que encontrar, a menos que tenha especificado na biblioteca de extens�o no seu mapa de contexto que n�o processa um determinado contexto.

O Outlook utiliza o mesmo perfil e outras informa��es de configura��o como o cliente do Exchange e pode utilizar todas as extens�es de cliente do Microsoft Exchange e formul�rios personalizados. Apesar do Outlook reconhece, carrega e executa extens�es que estejam em conformidade com as especifica��es para extens�es de cliente do Microsoft Exchange, pode melhorar o desempenho de uma extens�o e aumentar a funcionalidade em Outlook atrav�s do fornecimento um ficheiro de configura��o de extens�o (ECF). Utilizar um ECF, Outlook sabe antecipadamente os contextos sob o qual uma extens�o tem de ser carregados, os comandos a extens�o contribui, os m�dulos do Outlook ao qual se aplica a extens�o, e assim sucessivamente. Isto permite ao Outlook atrasar a carregar a extens�o at� ser necess�rio.

Sem um ECF o extens�o regista-se apenas o registo. Na entrada do registo, as informa��es que pode especificar uma extens�o est�o limitadas a uma DLL, um ponto de entrada, um mapa de contexto bin�rio, um mapa de interface bin�rio e um fornecedor, se aplic�vel. No entanto, um ECF permite uma extens�o para se registar com dados muito mais completos e detalhados. Se um ECF � carregada para uma extens�o, entradas de registo para a extens�o n�o s�o utilizadas. Consequentemente, o ECF tem cont�m uma descri��o completa da extens�o. O ECF fornece informa��es de textuais, utilizando o formato de ficheiro INI padr�o. Existe apenas um ECF por extens�o e apenas uma extens�o por ECF. Para obter mais informa��es sobre como escrever uma ECF, procure o t�pico "Outlook extens�o configura��o ficheiro de documento," na MSDN Library, documenta��o do Microsoft Office Development.

O cliente Outlook l� que apenas uma vez as informa��es de registo para uma extens�o e por motivos de desempenho, transfere-o para cache interna. Esta cache interna � o ficheiro extend.dat, localizado no direct�rio do Windows. O Outlook utiliza o ficheiro extend.dat para gravar caminhos a dll para todas as extens�es carregados no Outlook.

Iniciar uma sess�o de Outlook pela primeira vez, qualquer altura depois de instalar uma extens�o, desinstalado ou actualizado, Extend.dat ser�o escritas novamente com os novos caminhos DLL. Extens�es eliminadas deixar�o de ter uma entrada no ficheiro Extend.dat. Se foram carregadas indesejadas extens�es para o Outlook, ter� de remov�-los utilizando o Gestor Add-in manualmente. No Outlook 97, o Gestor de suplementos � acess�vel a partir do menu ' Ferramentas ' clicando em Op��es , seleccionando o separador Geral e clicando em Gestor de suplementos . Para remover uma extens�o, basta desloque at� localizar a extens�o, desmarque a caixa de verifica��o junto ao respectivo nome, clique em Remover e, em seguida, clique em OK . No Outlook 98, o Gestor de suplementos � acedido a partir do menu Ferramentas , clinking Op��es , em seguida, seleccionando o separador outras , clicar em Op��es avan�adas e seleccionando Gestor de suplementos .

O cliente do Exchange n�o tem um ficheiro Extend.dat, nem tem um Gestor de suplementos que utiliza ECFs.

Nota Uma das principais diferen�as entre dois clientes � o facto de que o Outlook n�o permite uma extens�o aceder a interface de utilizador do produto; ou seja, directamente manipular HWNDs. Se a extens�o de cliente do Exchange manipula as al�as de janela no Exchange Server, � prov�vel que esta extens�o n�o funcionar� correctamente no Outlook.

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

HKEY_LOCAL_MACHINE\Software\Microsoft\Exchange\Client\Extensions

Outlook, juntamente com a entrada de registo tradicional para a extens�o, deve adicionar uma entrada denominada "Extens�o de configura��o do Outlook" (n�o localize esta cadeia). O valor tem de ser:

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

Tem de ter:

HKEY_LOCAL_MACHINE\Software\Microsoft\Exchange\Client\Extensions

Esta entrada sinais Outlook que novas extens�es foram adicionadas ou removidas. O Outlook ir� remover esta entrada da pr�xima vez que � iniciado.

Nota No Windows Vista, Outlook n�o poder� eliminar esta chave executado numa conta de utilizador normal. Por conseguinte, quando instalar a extens�o de cliente Exchange dever� verificar a exist�ncia da chave:

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

e elimine-o. O Outlook n�o ir� carregar a extens�o se esta chave existir.

Voltar ao topo

Como aceder ao modelo de objectos do Outlook

Se pretender aceder o modelo de objectos do Outlook dentro de uma extens�o, a Microsoft publica uma interface de chamada IOutlookExtCallback para esta finalidade. O c�digo seguinte � o ficheiro 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

no ficheiro de cabe�alho para a extens�o, tem de incluir o seguinte c�digo:

#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 seguinte obt�m acesso a um IDispatch para o contexto actual:

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 devolve dois ponteiros o ponteiro para IOutlookExtCallback e o ponteiro para IDispatch. A primeira � devolvida caso o utilizador pretende executar outras fun��es. A Microsoft fornece apenas a fun��o GetOfficeCharacter. Se esta fun��o devolver nulo na ppdisp, a extens�o n�o est� em execu��o no Outlook. Este � um m�todo de determinar se o cliente que tem a extens�o, de facto, Outlook e o cliente do Exchange n�o aceit�vel. O autor da chamada � respons�vel pela libertar os ponteiros devolvidos.

Voltar ao topo

Leitura recomendado

O melhor recurso para aprender o modelo de objectos do Outlook � o Microsoft Outlook Visual Basic Reference. Este ficheiro de ajuda est� dispon�vel como parte de adicionar ferramentas de desenvolvimento - in que tamb�m inclui o Outlook Object Browser e depurador de scripts.

Tamb�m observe o seguinte:

O t�pico "Acerca de Client Extensions," na MSDN Library, documenta��o Platform SDK.
O artigo "Automatizar e expandir 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 ficheiro de documento," na MSDN Library, documenta��o do Microsoft Office Development.
Criar aplica��es com o Microsoft Outlook 98, nova edi��o. Krebs, Peter. A Microsoft Press, 1998. ISBN: 1-57231-718-3.
Desenvolver aplica��es para o Microsoft Exchange com o C++. Goetter, Bruno. A Microsoft Press, 1996. ISBN: 1-57231-500-8.
Interior COM. Rogerson, Microsoft Press Dale e., 1997. ISBN: 1-57231-349-8.
Interior MAPI. Cruz de la, Irving e Thaler, LES. A Microsoft Press, 1996. ISBN: 1-57231-312-9.
Programa��o de Win32. Newcomer, M. Joseph e Rector, Brent. Addison Wesley, c1997. S�rie: O avan�adas Windows s�rie. ISBN: 0-20163-492-9.

Nota Podem ser encomendados todos os livros Microsoft Press dispon�veis a partir do site Microsoft Press na Web em:

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

Voltar ao topo

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 ao topo

kbmt kbemail kbexchange kbprogramming kbdswnet2003swept kbinfo KB286408 KbMtpt

Voltar ao topo

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 revisto ou traduzido por humanos. A Microsoft tem artigos traduzidos por aplica��es (MT) e artigos traduzidos por tradutores profissionais. O objectivo � simples: oferecer em Portugu�s a totalidade dos artigos existentes na base de dados do suporte. Sabemos no entanto que a tradu��o autom�tica n�o � sempre perfeita. Esta pode conter erros de vocabul�rio, sintaxe ou gram�tica? erros semelhantes aos que um estrangeiro realiza ao falar em Portugu�s. A Microsoft n�o � respons�vel por incoer�ncias, erros ou estragos realizados na sequ�ncia da utiliza��o dos artigos MT por parte dos nossos clientes. A Microsoft realiza actualiza��es frequentes 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 ao topo

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��o

Introdu��o

Informa��es de fundo

O que � o cliente do Exchange?

O que � o cliente do Outlook?

O que � uma extens�o de cliente do Exchange?

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

Como aceder ao modelo de objectos do Outlook

Leitura recomendado

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

Palavras-chave:�

Outros Sites de Suporte

Comunidades

Obtenha Ajuda Agora

Tradu��es de Artigos

Centros de suporte relacionados