Entrar

Como implantar um projeto Access 2002 que inclui o Microsoft SQL Server 2000 Desktop Engine

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.

299297
Este artigo foi arquivado. É oferecido "como está" e não será mais atualizado.
Este artigo se aplica somente a um projeto Microsoft Access (.adp).

Avançadas: Requer especialista de codificação, interoperabilidade e habilidades de multiusuário.

Para uma versão deste artigo do Microsoft Office 2000 Developer, consulte 240293.

NESTA TAREFA

Sumário
O Microsoft SQL Server 2000 Desktop Engine (MSDE 2000) é um servidor de armazenamento de dados compatível com o SQL Server 2000 que está incluído no Microsoft Office XP Developer, com direitos para redistribuir. O Office XP Developer Packaging Wizard tem uma opção para incluir o SQL Server 2000 Desktop Engine quando um projeto Microsoft Access de embalagem (* .adp) solução. Quando a solução é instalada no computador de um usuário, o SQL Server 2000 Desktop Engine é instalado junto com a solução. No entanto, o SQL Server 2000 Desktop Engine não é iniciado, e o banco de dados não está anexado ao SQL Server 2000 Desktop Engine.

Observação : A versão anterior do Microsoft SQL Server 2000 Desktop Engine é denominada Microsoft Data Engine (MSDE).

Este artigo fornece o código que você deve usar para localizar o servidor, para iniciar o servidor se ele não estiver iniciado já, para anexar o banco de dados para o servidor e para conectar o projeto de banco de dados recém-anexado. O código é específico para usar em um projeto. No entanto, muito do código pode ser usado por qualquer do Visual Basic para aplicativos (VBA).

Microsoft fornece exemplos de programação apenas para ilustração, sem garantia expressa ou implícita. Isso inclui, mas não está limitado a, garantias implícitas de comercialização ou adequação para uma finalidade específica. Este artigo presume que você está familiarizados com a linguagem de programação que está sendo demonstrada e com as ferramentas que são usadas para criar e depurar procedimentos. Engenheiros de suporte podem ajudar a explicar a funcionalidade de um determinado procedimento, mas eles não modificarão esses exemplos para fornecer funcionalidades adicionais ou construir procedimentos para atender às suas necessidades. back to the top

Etapas para modificar um aplicativo de projeto existente para implantação

As etapas a seguir pressupõem que você já tenha um corretamente trabalhando aplicativo de projeto que está pronto para implantar. As etapas percorrer você como adicionar código adicional para seu projeto do VBA, como fazer ajustes necessários para seu formulário de inicialização e como criar um pacote de implantação para um projeto existente do Microsoft Access (* .adp) que inclui o SQL Server 2000 Desktop Engine.
  1. Abra o projeto do Access que você deseja implantar e, em seguida, crie um novo módulo.

    Como o código que você incluirá usa SQLDMO código e scripts, você deve certificar-se que as referências necessárias estão presentes.
  2. No menu Ferramentas do Editor do Visual Basic, clique em referências .
  3. Na caixa de diálogo referências , clique para selecionar o seguinte se eles já não estiverem selecionados:
    • Biblioteca de objetos Microsoft SQLDMO
    • @@@ Microsoft Scripting Runtime
  4. Clique em OK para fechar a caixa de diálogo referências .
  5. Copie o seguinte código para o novo módulo:
    Option Compare DatabaseOption ExplicitDim adp_UseIntegratedSecurity As BooleanPublic Function fStartUp(strDBName As String, strMDFName As String, _        Optional strUN As String, Optional strPW As String)'------------------------------------------------------------'The code in this project connects the MDF file'to a local MSDE, then establishes the connection between'the Access Project and MSDE.'------------------------------------------------------------    Dim strSQLInstances As String    Dim strServername As String    Dim intInst As Integer    Dim strMachineName As String    Dim spaceLocation As Long    'If no username is supplied, and you cannot 'use integrated security, the function requires that you provide a valid SQL Server user account and password.        If Not fCheckForCompatibleOS Then        strMachineName = "(local)"            If strUN = "" Then               MsgBox "Provide a valid SQL Server user account and password to log on to SQL Server because the current operating system does not support integrated security."               Exit Function            End If           adp_UseIntegratedSecurity = False    Else        strMachineName = ComputerName        If strUN = "" Then            adp_UseIntegratedSecurity = True        Else            adp_UseIntegratedSecurity = False        End If    End If    'Find the available instances of SQL 2000 on the computer.    intInst = GetValidSQLInstances(strSQLInstances)    If intInst < 1 Then        Dim strErrorMsg As String        strErrorMsg = "This application requires SQL Server 2000 " & _            "to be installed on the local computer."        MsgBox strErrorMsg, vbCritical, "SQL Server 2000 not installed!"        Exit Function    End If    'At this point, it has been determined that there is at    'least one valid SQL Server 2000 instance on the computer.    'The code below picks the default or first instance if more than    'one is available. You may want to add code to prompt the user for    'a choice when there is more than one instance on the computer.        If InStr(1, strSQLInstances, "MSSQLSERVER") Then        strServername = strMachineName    Else        spaceLocation = InStr(1, strSQLInstances, " ")        If spaceLocation = 0 Then            strServername = strMachineName & "\" & strSQLInstances        Else            strServername = strMachineName & "\" & Mid(strSQLInstances, 1, spaceLocation)        End If    End If        'Call fstartMSDE to connect to SQL Server    fStartMSDE strServername, strUN, strPW        'Call sCopyMDF to move the data file to the data folder    'of SQL Server, and then attach it to the server.    fCopyMDF strServername, strUN, strPW, strDBName, strMDFName        'Connect the ADP to the new database    fChangeADPConnection strServername, strDBName, strUN, strPWEnd FunctionPublic Function fStartMSDE(strServername As String, _                Optional strUN As String, Optional strPW As String)'------------------------------------------------------------'This subroutine will turn on MSDE. If the server has been'started, the error trap will exit the function leaving the'server running.''Note that it will not put the SQL Service Manager on'the start bar.''Input:'   strServername    The server to be started'   strUN        The user used to start server'   strPW        The password of user''Output:'   Resolution of start''References:'   SQLDMO'------------------------------------------------------------    Dim osvr As SQLDMO.SQLServer    Set osvr = CreateObject("SQLDMO.SQLServer")            On Error GoTo StartError 'Error Trap    osvr.LoginTimeout = 60    osvr.LoginSecure = adp_UseIntegratedSecurity    osvr.Start True, strServername, strUN, strPWExitSub:    Set osvr = Nothing    Exit FunctionStartError:    If Err.Number = -2147023840 Then    'This error is thrown when the server is already running,    'and Server.Start is executed on Windows NT, 2000, or XP.               osvr.Connect strServername, strUN, strPW  'Connect to Server                Else 'Unknown Error        MsgBox Err.Number & ": " & Err.Description    End If    Resume ExitSubEnd FunctionPublic Function fCopyMDF(strServername As String, _                strUN As String, strPW As String, _                strDBName As String, _                sMDFName As String)'------------------------------------------------------------'This Function determines whether the database is already on'the MSDE Server. If the database does not exist, this'function copies the MDF file from the same location as the'ADP to MSDE's Data directory and then attaches the database.''Input:'   strServername 	The server to be started'   strUN        	The user used to start server'   strPW 		The password of user'   strDBName 		The Name of the SQL Database'   sMDFName 		The Name of the MSDE Database to be copied''Output:'   Resolution of copy''References:'   SQLDMO'   Scripting Runtime'------------------------------------------------------------Dim FSO As Scripting.FileSystemObjectDim osvr As SQLDMO.SQLServerDim strMessage As StringDim db As VariantDim fDataBaseFlag As BooleanDim dbCount As IntegerOn Error GoTo sCopyMDFTrap    'The drive names used in FSO.Copyfile and    'oSvr.AttachDBWithSingleFile must match the    'locations for Program Files and MSDE on the    'computer of the end user.    fCopyMDF = ""    fDataBaseFlag = False    Set FSO = CreateObject("Scripting.FileSystemObject")    Set osvr = CreateObject("SQLDMO.SQLServer")    osvr.LoginSecure = adp_UseIntegratedSecurity    osvr.Connect strServername, strUN, strPW    dbCount = osvr.Databases.Count        'Look for database existence on Local MSDE Server    'by looping through all database names on the local    'MSDE Server.    For Each db In osvr.Databases            If db.Name = strDBName Then 'The database exists            fDataBaseFlag = True            Exit For 'Get out of loop        End If      Next        If Not fDataBaseFlag Then 'There is no database                              'matching sDBName        'Copy File to data folder.        FSO.CopyFile Application.CurrentProject.Path _        & "\" & sMDFName, _        osvr.Databases("master").PrimaryFilePath & _        sMDFName, True        'Attach to database.        strMessage = osvr.AttachDBWithSingleFile(strDBName, _            osvr.Databases("master").PrimaryFilePath _            & sMDFName)    End If     ExitCopyMDF:    osvr.Disconnect    Set osvr = NothingExit Function    sCopyMDFTrap:    If Err.Number = -2147216399 Then 'DMO must be initialized        Resume Next    Else        MsgBox Err.Description    End If        Resume ExitCopyMDFExit Function    End FunctionFunction MakeADPConnectionless()'------------------------------------------------------------'This code removes the connection properties from the'Access Project for troubleshooting purposes.'The ADP will open in a disconnected state until new connection'properties are supplied.'------------------------------------------------------------    Application.CurrentProject.OpenConnection ""End Function Function fChangeADPConnection(strServername, strDBName As String, Optional strUN As String, _        Optional strPW As String) As Boolean'------------------------------------------------------------'This Function resets the connection for an ADP by using the'input parameters to create a new connection string. If no username'is supplied, it tries to connect by using integrated security.''Input:'   strServerName    The server to be started'   strDBName   The Name of the MSDE Database'   strUN        The user used to start server'   strPW        The password of user'------------------------------------------------------------    Dim strConnect As String    On Error GoTo EH:    strConnect = "Provider=SQLOLEDB.1" & _    ";Data Source=" & strServername & _    ";Initial Catalog=" & strDBName    If adp_UseIntegratedSecurity Then        strConnect = strConnect & ";integrated security=SSPI"    Else        strConnect = strConnect & ";user id=" & strUN        strConnect = strConnect & ";password=" & strPW    End If    Application.CurrentProject.OpenConnection strConnect    fChangeADPConnection = True    Exit FunctionEH:    MsgBox Err.Number & ": " & Err.Description, vbCritical, "Connection Error"    fChangeADPConnection = FalseEnd Function					
  6. Salve este módulo como modCopyConnect .
  7. Criar um segundo módulo e copie o código a seguir para o segundo módulo:
    Option Compare DatabaseOption Explicit'This module provides functions that work together to'find existing computers running SQL Servers, and also the computer name.      Public Type OSVERSIONINFO    dwOSVersionInfoSize As Long    dwMajorVersion As Long    dwMinorVersion As Long    dwBuildNumber As Long    dwPlatformId As Long    szCSDVersion As String * 128End TypeDeclare Function GetVersionExA Lib "kernel32" _         (lpVersionInformation As OSVERSIONINFO) As IntegerPrivate Declare Function OSRegOpenKey Lib "advapi32" Alias _"RegOpenKeyA" (ByVal hKey As Long, ByVal lpszSubKey As String, _phkResult As Long) As LongPrivate Declare Function OSRegQueryValueEx Lib "advapi32" _Alias "RegQueryValueExA" (ByVal hKey As Long, _ByVal lpszValueName As String, ByVal dwReserved As Long, _lpdwType As Long, lpbData As Any, cbData As Long) As LongPrivate Declare Function GetComputerName _Lib "kernel32" Alias _"GetComputerNameA" (ByVal lpBuffer As String, _nSize As Long) As LongPrivate Declare Function OSRegCloseKey Lib "advapi32" _Alias "RegCloseKey" (ByVal hKey As Long) As LongPrivate Const MAX_COMPUTERNAME_LENGTH As Long = 15&Public Const HKEY_CLASSES_ROOT = &H80000000Public Const HKEY_CURRENT_USER = &H80000001Public Const HKEY_LOCAL_MACHINE = &H80000002Public Const HKEY_USERS = &H80000003Private Const ERROR_SUCCESS = 0&Private Const VER_PLATFORM_WIN32s = 0  'Win32s on Windows 3.1Private Const VER_PLATFORM_WIN32_WINDOWS = 1  'Windows 95/98/ME.Private Const VER_PLATFORM_WIN32_NT = 2  'Windows NT/2000/XPPrivate Const REG_SZ = 1Private Const REG_BINARY = 3Private Const REG_DWORD = 4Private Const REG_MULTI_SZ = 7Public Function GetValidSQLInstances(ByRef strSQLInstances _                As String) As Integer'-----------------------------------------------------------' This returns number of valid SQL instances and a space' delimited string that lists the instances.'-----------------------------------------------------------    Dim hKey As Long, i As Integer    Dim strVersionInfo As String    strSQLInstances = ""    GetValidSQLInstances = 0        If RegOpenKey(HKEY_LOCAL_MACHINE, _    "Software\Microsoft\Microsoft SQL Server", hKey) Then        RegQueryStringValue hKey, "InstalledInstances", strSQLInstances        RegCloseKey hKey        StrConv strSQLInstances, vbUpperCase        If InStr(1, strSQLInstances, "MSSQLSERVER") Then           If RegOpenKey(HKEY_LOCAL_MACHINE, _           "Software\Microsoft\MSSQLServer\MSSQLServer\CurrentVersion", _           hKey) Then                RegQueryStringValue hKey, "CurrentVersion", strVersionInfo                RegCloseKey hKey                If Mid(strVersionInfo, 1, 1) <> 8 Then                    Replace strSQLInstances, "MSSQLSERVER", ""                End If            End If        End If        Trim strSQLInstances        If Len(strSQLInstances) > 0 Then            GetValidSQLInstances = GetValidSQLInstances + 1        Else            Exit Function        End If        For i = 1 To Len(strSQLInstances)            If Mid$(strSQLInstances, i, 1) = " " Then                GetValidSQLInstances = GetValidSQLInstances + 1            End If        Next i    End IfEnd FunctionPublic Function RegOpenKey(ByVal hKey As Long, _ByVal lpszSubKey As String, phkResult As Long) As Boolean'-----------------------------------------------------------' FUNCTION: RegOpenKey' Opens an existing key in the system registry.' Returns: True, if the key opened successfully. False' otherwise.' Upon success, phkResult is set to the handle of the key.'-----------------------------------------------------------    Dim lResult As Long    Dim strHkey As String    strHkey = strGetHKEYString(hKey)    lResult = OSRegOpenKey(hKey, lpszSubKey, phkResult)    If lResult = ERROR_SUCCESS Then        RegOpenKey = True    End IfEnd FunctionPublic Function RegCloseKey(ByVal hKey As Long) As Boolean    Dim lResult As Long'-----------------------------------------------------------' FUNCTION: RegCloseKey' Closes an open registry key.' Returns: True on success, else False.'-----------------------------------------------------------    lResult = OSRegCloseKey(hKey)    RegCloseKey = (lResult = ERROR_SUCCESS)End FunctionPrivate Function strGetHKEYString(ByVal hKey As Long) As String'-----------------------------------------------------------'Given an HKEY, return the text string representing that key.'-----------------------------------------------------------    Dim strKey As String    Dim intIdx As Integer    strKey = strGetPredefinedHKEYString(hKey)    If Len(strKey) > 0 Then        strGetHKEYString = strKey        Exit Function    End If End FunctionPrivate Function strGetPredefinedHKEYString(ByVal _hKey As Long) As String'-----------------------------------------------------------'Given a predefined HKEY, return the text string representing'that key, or else return vbNullString.'-----------------------------------------------------------    Select Case hKey        Case HKEY_CLASSES_ROOT            strGetPredefinedHKEYString = "HKEY_CLASSES_ROOT"        Case HKEY_CURRENT_USER            strGetPredefinedHKEYString = "HKEY_CURRENT_USER"        Case HKEY_LOCAL_MACHINE            strGetPredefinedHKEYString = "HKEY_LOCAL_MACHINE"        Case HKEY_USERS            strGetPredefinedHKEYString = "HKEY_USERS"    End SelectEnd FunctionPublic Function RegQueryStringValue(ByVal hKey As Long, _ByVal strValueName As String, strData As String) As Boolean'-----------------------------------------------------------' Retrieves the string data for a named' (strValueName = name) or unnamed (Len(strValueName) = 0)' value in a registry key. If the named value' exists, but its data is not a string, this function' fails.'' Returns: True on success, else False.'   On success, strData is set to the string data value.'-----------------------------------------------------------    Dim lResult As Long    Dim lValueType As Long    Dim strBuf As String    Dim lDataBufSize As Long    lResult = OSRegQueryValueEx(hKey, strValueName, 0&, _              lValueType, _        ByVal 0&, lDataBufSize)    If lResult = ERROR_SUCCESS Then        If lValueType = REG_SZ Then            strBuf = space$(lDataBufSize)            lResult = OSRegQueryValueEx(hKey, strValueName, 0&, _                 0&, ByVal strBuf, lDataBufSize)            If lResult = ERROR_SUCCESS Then                RegQueryStringValue = True                strData = StringFromBuffer(strBuf)            End If                ElseIf lValueType = REG_MULTI_SZ Then            strBuf = space$(lDataBufSize)            lResult = OSRegQueryValueEx(hKey, strValueName, 0&, _                      0&, _                ByVal strBuf, lDataBufSize)            If lResult = ERROR_SUCCESS Then                RegQueryStringValue = True                strData = ReplaceNullsWithSpaces(strBuf)            End If        End If    End IfEnd FunctionPublic Function StringFromBuffer(Buffer As String) As String    Dim nPos As Long    nPos = InStr(Buffer, vbNullChar)    If nPos > 0 Then        StringFromBuffer = Left$(Buffer, nPos - 1)    Else        StringFromBuffer = Buffer    End IfEnd FunctionPublic Function ReplaceNullsWithSpaces(str As String) As String'-----------------------------------------------------------' Replace all null characters with spaces.'-----------------------------------------------------------    Dim i As Integer    If Len(str) > 0 Then        For i = 1 To Len(str)            If Mid$(str, i, 1) = vbNullChar Then                Mid$(str, i, 1) = " "            End If        Next i        ReplaceNullsWithSpaces = Left$(str, Len(str) - 2)    Else        ReplaceNullsWithSpaces = str    End IfEnd FunctionPublic Function ComputerName() As String'-----------------------------------------------------------'  Returns the local computer name.'-----------------------------------------------------------    Dim nLen As Long    Dim strComputerName As String    nLen = MAX_COMPUTERNAME_LENGTH    strComputerName = String$(nLen, 0)    GetComputerName strComputerName, nLen    strComputerName = Left$(strComputerName, nLen)    ComputerName = strComputerNameEnd Function  Public Function fCheckForCompatibleOS() As Boolean'-----------------------------------------------------------'  Checks to see if the OS can use integrated security.'-----------------------------------------------------------    Dim osinfo As OSVERSIONINFO    Dim retvalue As Integer    osinfo.dwOSVersionInfoSize = 148    osinfo.szCSDVersion = space$(128)    retvalue = GetVersionExA(osinfo)    If osinfo.dwPlatformId >= VER_PLATFORM_WIN32_NT Then        fCheckForCompatibleOS = True    Else        fCheckForCompatibleOS = False    End IfEnd Function
  8. Salve o módulo segundo como GetSQLInstances .
  9. Abra o formulário de inicialização existente no modo de design, ou crie um novo formulário de inicialização se você não tiver um formulário de inicialização.
  10. Adicione um comando à propriedade de evento OnOpen do formulário inicialização para chamar a função fStartUp .

    Você deve especificar o nome de banco de dados que você deseja criar no SQL Server e o nome de arquivo de dados do SQL Server existente. Você pode também especificar o nome de logon do SQL Server necessário e a senha como argumentos opcionais de terceiro e quarto se você não estiver usando segurança integrada. Por exemplo, se você deseja criar um banco de dados é chamado Northwind usando um arquivo de dados chamado NorthwindSQL.mdf, a função aparece da seguinte maneira:
    =fStartUp("Northwind","NorthwindSQL.mdf","","")
    Observação essa observação diz respeito à segurança do SQL Server. Se você não fornecer um nome de logon na chamada de função é mencionado anteriormente, o código neste artigo tenta usar segurança integrada se o sistema operacional subjacente pode oferecer suporte (Microsoft Windows NT 4.0, Microsoft Windows 2000 e Microsoft Windows XP). Se o sistema operacional subjacente é Microsoft Windows 98 ou Microsoft Windows Millennium Edition (Me), você precisará fornecer um conta de usuário válida do SQL Server e uma senha. Independentemente do sistema operacional, se você especificar pelo menos um nome de logon, o código tenta se conectar usando SQL Security com o nome de logon fornecido e senha. Se você não tiver uma cópia do seu arquivo de dados do SQL Server, você deve fazer uma cópia desse arquivo de dados para incluir com seu pacote de implantação.
  11. No menu Ferramentas , aponte para Utilitários de banco de dados e, em seguida, clique em Copiar Database File .
  12. Na caixa de diálogo Abrir resultante, especifique o nome e o local onde deseja salvar o arquivo de banco de dados, clique em Salvar para concluir o processo e, em seguida, fechar a caixa de diálogo. Quando o projeto é executado primeiro no computador de destino, o Access tenta se conectar ao SQL Server especificado nas propriedades do conexão do arquivo. Embora o código neste artigo ainda é executado e ainda atualiza as informações de conexão, é uma boa idéia remover informações de conexão existente antes de você implantar.

    Para remover informações de conexão existente, você pode executar a função MakeADPConnectionless() , que está incluída no módulo modCopyConnect.

  13. Para executar a função, digite o seguinte na Janela imediata e pressione ENTER:
    ?MakeADPConnectionless
  14. Salve as alterações.
  15. No menu Add-ins , se o Packaging Wizard estiver listado, vá para a etapa 19.
  16. No menu Add-ins , clique em Gerenciador de suplementos .
  17. Na lista de suplementos disponíveis , clique em Packaging Wizard .
  18. Para comportamento de carga, clique em Carregado/descarregado e, em seguida, clique em OK .
  19. No menu Add-ins , clique em Packaging Wizard .
  20. Siga as etapas no assistente até chegar à tela de dependências .
  21. Na tela de dependências , clique em Adicionar arquivo... para adicionar o arquivo MDF que você fez backup anteriormente.
  22. Clique em Avançar até chegar a tela Access Runtime propriedades . Nesta tela, clique para selecionar a caixa de seleção Microsoft SQL Server 2000 Desktop Engine (MSDE) para incluir o mecanismo do MSDE.
  23. Siga as etapas no Assistente para concluir o pacote, ou você pode clicar em Concluir sempre que desejar.
Depois que o pacote for criado, você estará pronto para instalar o pacote nos computadores dos usuários finais.

back to the top

Referências
Para obter informações adicionais sobre incluindo MSDE em pacotes para outros computadores, clique nos números abaixo para ler os artigos na Base de dados de Conhecimento da Microsoft:
290623Como anexar um banco de dados do SQL Server 2000 existente ao SQL Server 2000 Desktop Engine
322228Incorporar o programa de instalação do MSDE 2000 a instalação de aplicativos personalizados (white paper)
274199Não pode instalar o MSDE 2000 no Windows 95
299351Erro: A instalação do MSDE Falha em sistemas que tenham o SQL Server 2000 Service Pack 1 ou 2 instalado
Para obter informações adicionais sobre como submeter ao upsizing seu banco de dados para o SQL 2000 Desktop Engine, clique no número abaixo para ler o artigo na Base de dados de Conhecimento da Microsoft:
325023Submeter ao upsizing SQL Server 2000 Desktop Engine para o SQL Server
back to the top
offxpdev ACCXP ACC2002

Warning: This article has been translated automatically

Propriedades

ID do Artigo: 299297 - Última Revisão: 10/23/2013 19:54:52 - Revisão: 5.1

  • Microsoft Office XP Developer Edition
  • Microsoft Access 2002 Standard Edition
  • kbnosurvey kbarchive kbmt kbhotfixserver kbqfe kbhowto kbadp kbfaq KB299297 KbMtpt
Comentários