ID do artigo: 173011 - Última revisão: terça-feira, 29 de junho de 2004 - Revisão: 2.1

Como adicionar e conexões de rede remover

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.

Nesta página

Expandir tudo | Recolher tudo

Sumário

Este artigo demonstra como criar e remover conexões de rede usando funções da API do Windows através de programação. O exemplo a seguir adicionará uma conexão para um compartilhamento de rede e será desconectada do mesmo compartilhamento.

Mais Informações

Observação: Este código inclui apenas interceptação de erro mínimo. Ele somente reporta êxito ou falha das chamadas API. Qualquer uso de produção desse código deve examinar os valores retornados pelas funções de API e manipular adequadamente os erros. As constantes de erro mais comuns são listadas para essa finalidade.

Etapas para reproduzir o problema

  1. Crie um novo projeto Standard EXE.
  2. Adicione um módulo para o projeto.
  3. Copiar e colar a seguir declara e tipo no módulo: (Observação: se você adicionar isso para um módulo de formulário, verifique todas as entradas particular.)
          Declare Function WNetAddConnection2 Lib "mpr.dll" Alias _
          "WNetAddConnection2A" (lpNetResource As NETRESOURCE, _
          ByVal lpPassword As String, ByVal lpUserName As String, _
          ByVal dwFlags As Long) As Long
    
          Declare Function WNetCancelConnection2 Lib "mpr.dll" Alias _
          "WNetCancelConnection2A" (ByVal lpName As String, _
          ByVal dwFlags As Long, ByVal fForce As Long) As Long
    
          Type NETRESOURCE
            dwScope As Long
            dwType As Long
            dwDisplayType As Long
            dwUsage As Long
            lpLocalName As String
            lpRemoteName As String
            lpComment As String
            lpProvider As String
          End Type
    
          Public Const NO_ERROR = 0
          Public Const CONNECT_UPDATE_PROFILE = &H1
          ' The following includes all the constants defined for NETRESOURCE,
          ' not just the ones used in this example.
          Public Const RESOURCETYPE_DISK = &H1
          Public Const RESOURCETYPE_PRINT = &H2
          Public Const RESOURCETYPE_ANY = &H0
          Public Const RESOURCE_CONNECTED = &H1
          Public Const RESOURCE_REMEMBERED = &H3
          Public Const RESOURCE_GLOBALNET = &H2
          Public Const RESOURCEDISPLAYTYPE_DOMAIN = &H1
          Public Const RESOURCEDISPLAYTYPE_GENERIC = &H0
          Public Const RESOURCEDISPLAYTYPE_SERVER = &H2
          Public Const RESOURCEDISPLAYTYPE_SHARE = &H3
          Public Const RESOURCEUSAGE_CONNECTABLE = &H1
          Public Const RESOURCEUSAGE_CONTAINER = &H2
          ' Error Constants:
          Public Const ERROR_ACCESS_DENIED = 5&
          Public Const ERROR_ALREADY_ASSIGNED = 85&
          Public Const ERROR_BAD_DEV_TYPE = 66&
          Public Const ERROR_BAD_DEVICE = 1200&
          Public Const ERROR_BAD_NET_NAME = 67&
          Public Const ERROR_BAD_PROFILE = 1206&
          Public Const ERROR_BAD_PROVIDER = 1204&
          Public Const ERROR_BUSY = 170&
          Public Const ERROR_CANCELLED = 1223&
          Public Const ERROR_CANNOT_OPEN_PROFILE = 1205&
          Public Const ERROR_DEVICE_ALREADY_REMEMBERED = 1202&
          Public Const ERROR_EXTENDED_ERROR = 1208&
          Public Const ERROR_INVALID_PASSWORD = 86&
          Public Const ERROR_NO_NET_OR_BAD_PATH = 1203&
    
    						
  4. Adicione dois CommandButtons ao Form1. Esses serão Command1 e Command2 por padrão.
  5. Adicione o seguinte código para Form1, substituindo um nome de compartilhamento válido para "\\nome_do_servidor\nome_do_compartilhamento":
          Option Explicit
    
          Private Sub Command1_Click()
          Dim NetR As NETRESOURCE
          Dim ErrInfo As Long
          Dim MyPass As String, MyUser As String
    
          NetR.dwScope = RESOURCE_GLOBALNET
          NetR.dwType = RESOURCETYPE_DISK
          NetR.dwDisplayType = RESOURCEDISPLAYTYPE_SHARE
          NetR.dwUsage = RESOURCEUSAGE_CONNECTABLE
          NetR.lpLocalName = "X:" ' If undefined, Connect with no device
          NetR.lpRemoteName = "\\ServerName\ShareName"   ' Your valid share
          'NetR.lpComment = "Optional Comment"
          'NetR.lpProvider =    ' Leave this undefined
    
          ' If the MyPass and MyUser arguments are null (use vbNullString), the
          ' user context for the process provides the default user name.
          ErrInfo = WNetAddConnection2(NetR, MyPass, MyUser, _
          CONNECT_UPDATE_PROFILE)
          If ErrInfo = NO_ERROR Then
            MsgBox "Net Connection Successful!", vbInformation, _
            "Share Connected"
          Else
            MsgBox "ERROR: " & ErrInfo & " - Net Connection Failed!", _
            vbExclamation, "Share not Connected"
          End If
          End Sub
    
          Private Sub Command2_Click()
          Dim ErrInfo As Long
          Dim strLocalName As String
    
          ' You may specify either the lpRemoteName or lpLocalName
          'strLocalName = "\\ServerName\ShareName"
          strLocalName = "X:"
          ErrInfo = WNetCancelConnection2(strLocalName, _
          CONNECT_UPDATE_PROFILE, False)
          If ErrInfo = NO_ERROR Then
            MsgBox "Net Disconnection Successful!", vbInformation, _
            "Share Disconnected"
          Else
            MsgBox "ERROR: " & ErrInfo & " - Net Disconnection Failed!", _
            vbExclamation, "Share not Disconnected"
          End If
          End Sub
    
    						
Executar o projeto e clique no Command1. Você obterá uma caixa de diálogo mensagem indicando êxito ou falha. Se for bem-sucedido, você poderá examinar o Windows Explorer e ver a nova conexão (a menos que esquerda lpLocalName indefinido, caso em que a conexão não é exibido no Explorer). Clique em Command2 e vá para o Explorer, onde você verá que a conexão foi removida.

Referências

Para obter informações sobre as limitações usando WNetAddConnection2 em plataformas diferentes do Windows, consulte o seguinte artigo na Base de dados de Conhecimento da Microsoft:
183366  (http://support.microsoft.com/kb/183366/EN-US/ ) : INFO: WNetAddConnection2 e usuário várias credenciais


Para obter mais informações, pesquisa os tópicos seguintes em Win32 Programmer referência ou CD do Microsoft Developer Network Library:
  • WNetAddConnection2
  • WNetCancelConnection2
  • NETRESOURCE

A informação contida neste artigo aplica-se a:
  • Microsoft Visual Basic 6.0 Learning Edition
  • Microsoft Visual Basic 5.0 Learning Edition
  • Microsoft Visual Basic 6.0 Professional Edition
  • Microsoft Visual Basic 5.0 Professional Edition
  • Microsoft Visual Basic Enterprise Edition for Windows 6.0
  • Microsoft Visual Basic 5.0 Enterprise Edition
  • Microsoft Visual Basic Control Creation Edition
  • Microsoft Visual Basic 4.0 Standard Edition
  • Microsoft Visual Basic 4.0 Professional Edition
  • Microsoft Visual Basic 4.0 de 32 Bits Enterprise Edition
Palavras-chave: 
kbmt kbgrpdsvb kbhowto KB173011 KbMtpt
Tradução automáticaTraduçã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: 173011  (http://support.microsoft.com/kb/173011/en-us/ )