Como Redistributing DAO com O Visual C++ 5.0 aplicação

Existem 2 abordagens para redistribuir DAO 3.5 com a aplicação de Visual C++ 5.0:

• Pode redistribuir a configuração de DAO localizado no VC\REDIST\DAO directório.
  
  - ou -
• Pode seguir os passos Daosetup.rtf instalado com o SDK do DAO.

Note que as informações no tópico "Instalar DAO no outro computador" para o SDK do DAO são incorrectas e as informações devem ser ignoradas.

Redistribuir o programa de configuração do DAO

No CD do Visual C++ 5.0, \DEVSTUDIO\VC\REDIST\DAO\DISK1\, existe um programa de configuração DAO que pode ser redistribuído. Este programa de configuração pede ao utilizador para obter informações sobre os componentes a instalar. Pode executar o programa de configuração com um '-s ' opção silenciosamente executa o programa de configuração do DAO sem colocar informações no ecrã.

Seguem-se algumas notas importantes:

• Se executar o programa com a opção -s, todos os componentes DAO será instalado (DAO componentes principais, ODBC directa e ISAMs).
• Se ODBCDirect é seleccionado ou escolheu o '-s ' opção, tem de ter ODBC 3.0 actualmente instalada no sistema.
• Para registar DAO e utilizar o DAO, tem de ter versão do ficheiro Oleaut32.dll 2.20.4049 ou posterior, bem como stdole2.tlb instalado no seu sistema directório. Se tentar executar o programa de configuração com a "-s" opção e não tem versão 2.20.4049 ou posterior, o programa de configuração falha. Para obter estas versões mais recentes dos ficheiros, consulte o seguinte artigo na base de dados de conhecimento da Microsoft:
  180071  (http://support.microsoft.com/kb/180071/EN-US/ ) FICHEIRO: Msvbvm50.exe instala ficheiros de tempo de execução do Visual Basic 5.0

Instalar os componentes DAO com o próprio programa de configuração

Abaixo são as informações do ficheiro Daosetup.rtf instalado para o directório DAO SDK.

NOTA: A documentação não mencionar que tem de copiar os ficheiros Oleaut32.dll e Stdole2.TLB a partir do directório \devstudio\vc\redist no CD do Visual C++ 5.0 para o directório do sistema Windows. Tem de registar o ficheiro Oleaut32.dll.

Este documento descreve os passos necessários para criar um programa de configuração instala com êxito DAO e respectivos ficheiros relacionados. Recomenda-se que utilize InstallShield Express que é fornecido com o Visual C++ 5.0 juntamente com as informações neste documento para criar o programa de configuração.

Configuração adequada do DAO é muito importante. Uma vez que DAO é um componente partilhado que existe apenas uma localização num computador, todas as aplicações utilizando DAO poderão deixar de funcionar se o programa de configuração do DAO não é correctamente efectuado.

1. Introdução
   
   Para distribuir uma aplicação que utilize DAO, tem de instalar as partes redistribuíveis do DAO. Dependendo se a aplicação utiliza áreas de trabalho Motor Microsoft Jet ou ODBCDirect, tem de instalar também um as partes redistribuíveis do motor de base de dados Microsoft Jet, as partes de objectos de base de dados (RDO) remoto redistribuíveis ou ambos.
   
   DAO, do Microsoft Jet e RDO requerem um procedimento de instalação mais complexo do que simplesmente copiar ficheiros para um directório. Uma aplicação não pode ter sua própria cópia "privada" de um servidor de automatização OLE (tal como o DAO) num directório de aplicação. O servidor é registado por OLE e todos os utilizadores utilizam a mesma DLL.
2. Ficheiros
   
   O DAO e ODBCDirect do DAO requerem um conjunto principal de ficheiros. Microsoft Jet também tem um principal e um segundo conjunto opcional que fornece a capacidade de aceder a outros formatos de dados.
   
   Se a aplicação utiliza ODBCDirect ou o motor Microsoft Jet para aceder a dados determina se deve instalar o motor Microsoft Jet ou ficheiros de ODBCDirect.
   
   Apenas os ficheiros descritos nesta secção podem ser distribuídos com a aplicação a outros utilizadores. Não é possível distribuir outros ficheiros, tais como ficheiros .hlp ou ficheiros de cabeçalho (.h) DAO.
   
   NOTA: O directório DAO e o directório System32 são explicadas na secção 3.2.
   
   
   1. DAO
      
      DAO é composto pelos seguintes ficheiros principais (estes ficheiros tem de ser instalados para DAO para função):

            File         Description          Installed   Registered  Directory
            -------------------------------------------------------------------
            
            DAO350.DLL    DAO version 3.5      Shared        Yes       DAO
            DAO2535.TLB   Type Library         Companion     No        DAO
                                               to DAO350.DLL
            MSJTER35.DLL  Microsoft Jet        System        No        System32
                          (and DAO) error
                          message DLL
            MSJINT35.DLL  Localized Microsoft  System        No        System32
                          Jet (and DAO) error
                          strings
            MSVCRT40.DLL  C Runtime DLL        System        No        System32
          
      								

   2. Motor Microsoft Jet
      
      
      1. Componentes essenciais de ficheiros do Jet
         Microsoft Jet é composto pelos seguintes ficheiros principais. Estes ficheiros são suficientes para aceder a bases de dados .mdb do versão 3.0 e ODBC origens de dados (em conjunto com um controlador ODBC instalado) quando instalado com o DAO.

               File         Description          Installed   Registered  Directory
               -------------------------------------------------------------------
               
               MSJET35.DLL  Microsoft Jet engine  System         Yes     System32
                            (version 3.5)
               MSRD2X35.DLL MDB files from       Companion       Yes     System32
                            Microsoft Access     to MSJET35.DLL
                            2.0, Visual Basic
                            3.0 or earlier
               MSJTER35.DLL Microsoft Jet (and   System          No      System32
                            DAO) error message
                            DLL
               MSJINT35.DLL Localized Microsoft  System          No      System32
                            Jet (and DAO) error
                            strings
               VBAJET32.DLL VBA-Microsoft Jet    System          No      System32
                            Expression service
               VBAR332.DLL  VBA Runtime          System          No      System32
             
         										

      2. Ficheiros opcionais
         Os seguintes ficheiros opcionais fornecem acesso a outros formatos de dados. Instalar as DLLs que correspondem o formato de ficheiro necessários para suportar, ou se tiver o suporte de replicação.

               Module        Description         Installed   Registered  Directory
               -------------------------------------------------------------------
               
               MSREPL35.DLL  Microsoft Jet       System      No          System32
                             Replication
               MSXBSE35.DLL  Xbase formats       System      Yes         System32
               MSPDOX35.DLL  Paradox formats     System      Yes         System32
               MSTEXT35.DLL  Text files          System      Yes         System32
               MSEXCL35.DLL  Spreadsheet files   System      Yes         System32
               MSLTUS35.DLL  Lotus formats       System      Yes         System32
               MSEXCH35.DLL  Exchange formats    System      Yes         System32
                
         										

   3. ODBCDirect
      
      Instale os seguintes ficheiros para suportar a funcionalidade de ODBCDirect. DAO utiliza RDO para processar a respectiva funcionalidade ODBCDirect. Por este motivo poderá reconhecer estes ficheiros como ficheiros principais RDO.

            File          Description          Installed   Registered  Directory
            -------------------------------------------------------------------
            
            MSRDO20.dll  Remote Database       Shared          Yes     System32
                         Objects 2.0
            RDOCURS.dll  Batch Client Cursor   Companion       No*     System32
                         Library               to MSRDO20.DLL
          
      								

   * Rdocurs.dll não é um servidor de COM (que não exporta DllRegisterServer) pelo que não está registado. O Daosetup.rtf é incorrecta e não deve ser executado Regsrv32.exe contra Rdocurs.dll.
3. Instalação
   As secções seguintes fornecem informações sobre como utilizar o procedimento de instalação.
   
   
   1. Verificar se os ficheiros estão em utilização.
      O primeiro passo no procedimento de instalação é se programas que estão a utilizar quaisquer ficheiros que pode instalar estão em execução. Se forem poderá ser necessário abortar a instalação e pedir ao utilizador que feche outras aplicações antes de instalar o DAO.
   2. Copie os ficheiros.
      Copie todos os ficheiros listados como ficheiros DAO (excepto o Dao350.dll e Dao2535.tlb) e todos os ficheiros principais do motor Microsoft Jet (e ficheiros opcional específico da aplicação) ou ficheiros de ODBCDirect (consoante as necessidades da aplicação) ao directório de sistema (system32 para o Windows NT) (referido nos gráficos acima como directório System32). Por normas DLL normais, terá de copiar com verificação da versão para garantir que uma versão mais recente do ficheiro não será substituída pela instalação. Todos os ficheiros DAO contêm recursos versão adequada.
      
      Utilize o seguinte procedimento para copiar Dao350.dll e Dao2535.tlb:
      
      
      1. Para o Windows NT (versão anterior à 4.0), os ficheiros DAO vão sempre em <windows> \MSAPPS\DAO. Por exemplo, c:\winnt35\msapps\DAO. Para o Windows 95 ou Windows NT 4.0, o directório DAO é aproximadamente c:\Programas\Microsoft c:\Programas\Ficheiros comuns\Microsoft Shared\DAO. A localização exacta varia se o utilizador tiver uma versão não inglesa do Windows 95, deve ler a localização do registo. Localize o nó seguinte no registo:

                     HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion
                
         										

         e obter o valor da chave denominada CommonFilesDir.
      2. Se esta chave de registo não existir, em seguida, criá-la e defina o valor como:

                     \Program Files\Common Files
                
         										

         Certifique-se utilizar a letra da unidade correcta.
      3. Depois de ter o valor da chave, que é normalmente:

                     c:\Program Files\Common Files
                
         										

         , em seguida, anexar "\Microsoft Shared\DAO" e utilizar que como a localização de destino para Dao350.dll os Dao2535.tlb.
      4. Copie Dao350.dll e Dao2535.tlb para este directório utilizando a verificação da versão. Este é o directório referido nos gráficos acima como directório DAO.
   3. Registe as DLLs.
      Depois de copiar todos os das DLLs, terá de registá-los. Para tal, a chamar o ponto de entrada DLLRegisterServer em cada DLL caso exista. Note que, uma vez que DAO requer o Microsoft Jet-pode registar com êxito, a ordem de cópia de ficheiros fornecidos anteriormente é importante.
      
      O programa de configuração deve utilizar regsvr32.exe ou uma chamada equivalente para executar o DLLRegisterServer nas seguintes dll (se estas tiverem sido instaladas pelo passo 3b): Dao350.dll, Msjet35.dll, Msrd2x35.dll, Msexcl35.dll, Mspdox35.dll, Msxbse35.dll, Msltus35.dll, Mstext35.dll, Msexch35.dll, Msrdo20.dll.
      
      Seguem-se algumas considerações especiais que deve ter em mente:
      
      
      • Dao350.dll tem de ter Msvcrt40.dll e outros ficheiros necessários no computador, pode registar. Se falhar DAO registar, verifique a versão do MSVCRT40.DLL. Problemas são normalmente visualizados no Windows 95 em que a versão deve ser 4.10.6038 (ficheiro cerca 319 K).
      • Msrdo20.dll necessita de ODBC instalado antes de serão registados. Utilize o programa de instalação de ODBC para instalar o ODBC.
      • Msexch35.dll tem de ter instalado no sistema podem registar de MAPI.
   4. Actualize as contagens de referência de ficheiro.
      Porque DAO é partilhado por muitos programas, é mantida uma contagem de como número de vezes que a DLL foi instalada. Isto permite aos programas desinstalar remover o ficheiro apenas quando nenhum programa necessita. Este é o mesmo para o Msrdo20.dll. Outros ficheiros nunca são removidos do sistema.
      
      
      1. Na seguinte localização, procurar uma chave com o mesmo nome que o ficheiro que instalou:

             HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\SharedDlls\ 
                
         										

      2. Se a chave existir, incrementar o valor por uma (que é uma dword). Se a chave não existir, terá de criar uma chave que é o nome do ficheiro (incluindo o caminho) do tipo dword e atribuir-lhe um valor de 1. Uma entrada comum seria:

                  \\Program Files\\Common Files\\Microsoft Shared\\DAO
                     \\DAO350.DLL"=dword:00000001
                
         										

         (Este exemplo é o formato de exportação utilizada regedit; só deverá utilizar barras invertidas simples ao criar a chave.)
         
         Certifique-se de referência contar tanto o Msrdo20.dll o Dao350.dll.
4. Desinstalar
   Para estiver em conformidade com directrizes de Windows 95, programas tem de poder desinstalar próprios e remover todos os ficheiros e entradas de registo criam. Muitos toolkits o programa de configuração, tais como o toolkit de InstallShield fornecido, fornecer esta funcionalidade "incorporado". É no âmbito deste documento para fornecer todos os detalhes dos requisitos de instalação do Windows 95, mas Eis os passos básicos necessários para desinstalar o DAO. Tenha em atenção que apenas os componentes partilhados e os respectivos ficheiros associados serão removidos. Os ficheiros de sistema instalado nunca serão removidos.
   
   Dao350.dll os Dao2535.tlb serão removidas se o valor da chave de contagem de referência do Dao350.dll é 1. Caso contrário, a contagem é reduzida e o ficheiro permanecem no local. Por exemplo:
   
   HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\SharedDlls\ "Pasta c:\Programas\Ficheiros comuns\Microsoft Shared\DAO\DAO350.dll"
   
   Antes de remover Dao350.dll, terá de chamar o DLLUnregisterServer de ponto de entrada, de modo que pode remover os respectivos movimentos a partir do registo. Pode fazê-lo utilizando a ferramenta Regsvr32.exe com a opção -u.
   
   As mesmas regras aplicam-se para o Msrdo20.dll e é ficheiro complementar de Rdocurs.dll.