Como utilizar com o nome encaminhamentos (pipes) num programa de 32 bits do Visual Basic

Traduções de Artigos Traduções de Artigos
Artigo: 177696 - Ver produtos para os quais este artigo se aplica.
Expandir tudo | Reduzir tudo

Nesta página

Sumário

Visual Basic pode criar aplicações que comunicam a outros processos através de pipes nomeados. Encaminhamento com nome tem de ser criado no Windows 2000 ou Windows NT; no entanto, pode ler e escrever desse encaminhamento a partir de qualquer plataforma de 32 bits.

Este artigo demonstra comunicação de cliente/servidor utilizando um encaminhamento com nome no Visual Basic.

Mais Informação

Neste artigo, o processo de criar o NamedPipe denomina-se o servidor e o processo de ligar ao pipe nomeado denomina-se o cliente.

Existem seis passos para criar um servidor de pipe nomeado:
  1. Crie um token de segurança para o pipe permitir o acesso a (para disponibilizar um encaminhamento com nome a qualquer processo criando um token de segurança com um discricionária controlo de acesso List (DACL) que tenha zero entradas).
  2. Crie o pipe nomeado.
  3. Chame ConnectNamedPipe bloquear até que um cliente estabelece ligação.
  4. Chame ReadFile e/ou WriteFile para comunicar com o encaminhamento (pipe).
  5. Chamar DisconnectNamedPipe quando o processo é concluído com o encaminhamento (pipe).
  6. Qualquer CloseHandle no pipe nomeado ou ir para o passo 4.
Existem três passos para utilizar um encaminhamento com o nome do cliente de encaminhamento com nome:
  1. Chame CreateFile obter um identificador para o encaminhamento com nome.
  2. Chame ReadFile e/ou WriteFile para comunicar com o encaminhamento (pipe).
  3. Chamar CloseHandle no filehandle criado CreateFile.
Em alternativa, pode chamar CallNamedPipe, que executa uma transacção única sobre o encaminhamento (pipe). CallNamedPipe abre o pipe, escreve-lo, lê do mesmo e fecha o pipe. Este é o que faz o cliente abaixo.

O exemplo seguinte demonstra como criar um servidor de encaminhamento (pipe) com o nome e um cliente. Implementa apenas as funções mais rudimentares necessárias para o fazer, com uma quantidade mínima de verificação de erros. Um programa totalmente funcional deve verificar os valores devolvidos do API que é chamados, em vez partindo do princípio que tiveram êxito.

Servidor de encaminhamento (pipe) com nome

  1. Crie um novo projecto. É criado o Form1 por predefinição.
  2. Adicione o seguinte código ao formulário:
       Option Explicit
       Private Const szPipeName = "\\.\pipe\bigtest"
       Private Const BUFFSIZE = 20000
       Private BigBuffer(BUFFSIZE) As Byte, pSD As Long
       Private sa As SECURITY_ATTRIBUTES
       Private hPipe As Long
    
       Private Sub Form_Click()
          Dim i As Long, dwOpenMode As Long, dwPipeMode As Long
          Dim res As Long, nCount As Long, cbnCount As Long
          For i = 0 To BUFFSIZE - 1       'Fill an array of numbers
             BigBuffer(i) = i Mod 256
          Next i
    
          'Create the NULL security token for the pipe
          pSD = GlobalAlloc(GPTR, SECURITY_DESCRIPTOR_MIN_LENGTH)
          res = InitializeSecurityDescriptor(pSD, SECURITY_DESCRIPTOR_REVISION)
          res = SetSecurityDescriptorDacl(pSD, -1, 0, 0)
          sa.nLength = LenB(sa)
          sa.lpSecurityDescriptor = pSD
          sa.bInheritHandle = True
    
          'Create the Named Pipe
          dwOpenMode = PIPE_ACCESS_DUPLEX Or FILE_FLAG_WRITE_THROUGH
          dwPipeMode = PIPE_WAIT Or PIPE_TYPE_MESSAGE Or PIPE_READMODE_MESSAGE
          hPipe = CreateNamedPipe(szPipeName, dwOpenMode, dwPipeMode, _
                                  10, 10000, 2000, 10000, sa)
    
          Do  'Wait for a connection, block until a client connects
             res = ConnectNamedPipe(hPipe, ByVal 0)
    
             'Read/Write data over the pipe
             cbnCount = 4
    
             res = ReadFile(hPipe, nCount, LenB(nCount), cbnCount, ByVal 0)
    
             If nCount <> 0 Then
    
                If nCount > BUFFSIZE Then 'Client requested nCount bytes
                   nCount = BUFFSIZE      'but only send up to 20000 bytes
                End If
                'Write the number of bytes requested
                res = WriteFile(hPipe, BigBuffer(0), nCount, cbnCount, ByVal 0)
                'Make sure the write is finished
                res = FlushFileBuffers(hPipe)
             End If
    
             'Disconnect the NamedPipe
             res = DisconnectNamedPipe(hPipe)
          Loop Until nCount = 0
    
          'Close the pipe handle
          CloseHandle hPipe
          GlobalFree (pSD)
          End
       End Sub
    					
  3. Crie um novo módulo e adicione as declarações seguintes:
       Option Explicit
    
       Public Const FILE_ATTRIBUTE_NORMAL = &H80
       Public Const FILE_FLAG_NO_BUFFERING = &H20000000
       Public Const FILE_FLAG_WRITE_THROUGH = &H80000000
    
       Public Const PIPE_ACCESS_DUPLEX = &H3
       Public Const PIPE_READMODE_MESSAGE = &H2
       Public Const PIPE_TYPE_MESSAGE = &H4
       Public Const PIPE_WAIT = &H0
    
       Public Const INVALID_HANDLE_VALUE = -1
    
       Public Const SECURITY_DESCRIPTOR_MIN_LENGTH = (20)
       Public Const SECURITY_DESCRIPTOR_REVISION = (1)
    
       Type SECURITY_ATTRIBUTES
               nLength As Long
               lpSecurityDescriptor As Long
               bInheritHandle As Long
       End Type
    
       Public Const GMEM_FIXED = &H0
       Public Const GMEM_ZEROINIT = &H40
       Public Const GPTR = (GMEM_FIXED Or GMEM_ZEROINIT)
    
       Declare Function GlobalAlloc Lib "kernel32" ( _
          ByVal wFlags As Long, ByVal dwBytes As Long) As Long
       Declare Function GlobalFree Lib "kernel32" (ByVal hMem As Long) As Long
       Declare Function CreateNamedPipe Lib "kernel32" Alias _
          "CreateNamedPipeA" ( _
          ByVal lpName As String, _
          ByVal dwOpenMode As Long, _
          ByVal dwPipeMode As Long, _
          ByVal nMaxInstances As Long, _
          ByVal nOutBufferSize As Long, _
          ByVal nInBufferSize As Long, _
          ByVal nDefaultTimeOut As Long, _
          lpSecurityAttributes As Any) As Long
    
       Declare Function InitializeSecurityDescriptor Lib "advapi32.dll" ( _
          ByVal pSecurityDescriptor As Long, _
          ByVal dwRevision As Long) As Long
    
       Declare Function SetSecurityDescriptorDacl Lib "advapi32.dll" ( _
          ByVal pSecurityDescriptor As Long, _
          ByVal bDaclPresent As Long, _
          ByVal pDacl As Long, _
          ByVal bDaclDefaulted As Long) As Long
    
       Declare Function ConnectNamedPipe Lib "kernel32" ( _
          ByVal hNamedPipe As Long, _
          lpOverlapped As Any) As Long
    
       Declare Function DisconnectNamedPipe Lib "kernel32" ( _
          ByVal hNamedPipe As Long) As Long
    
       Declare Function WriteFile Lib "kernel32" ( _
          ByVal hFile As Long, _
          lpBuffer As Any, _
          ByVal nNumberOfBytesToWrite As Long, _
          lpNumberOfBytesWritten As Long, _
          lpOverlapped As Any) As Long
    
       Declare Function ReadFile Lib "kernel32" ( _
          ByVal hFile As Long, _
          lpBuffer As Any, _
          ByVal nNumberOfBytesToRead As Long, _
          lpNumberOfBytesRead As Long, _
          lpOverlapped As Any) As Long
    
       Declare Function FlushFileBuffers Lib "kernel32" ( _
          ByVal hFile As Long) As Long
    
       Declare Function CloseHandle Lib "kernel32" ( _
          ByVal hObject As Long) As Long
    					
  4. Guarde o formulário.

Cliente de encaminhamento (pipe) com nome

  1. Crie um novo projecto. É criado o Form1 por predefinição.
  2. Adicione os seguintes controlos ao formulário:
       Type             Name               Caption/Default Value
       ----             ----               ---------------------
       TextBox          cbBytes            500
       CommandButton    cmdCallNamedPipe   Call Named Pipe
       TextBox          txtReceive
    					
  3. Adicione o seguinte código ao formulário:
       Option Explicit
       Private Const szPipeName = "\\.\pipe\bigtest", BUFFSIZE = 20000
       Private Declare Function CallNamedPipe Lib "kernel32" Alias _
          "CallNamedPipeA" ( _
          ByVal lpNamedPipeName As String, _
          lpInBuffer As Any, _
          ByVal nInBufferSize As Long, _
          lpOutBuffer As Any, _
          ByVal nOutBufferSize As Long, _
          lpBytesRead As Long, _
          ByVal nTimeOut As Long) As Long
    
       Private Sub cmdCallNamedPipe_Click()
          Dim res As Long, myStr As String, i As Long, cbRead As Long
          Dim numBytes As Long, bArray() As Byte, temp As String
    
          numBytes = cbBytes.Text
          If cbBytes.Text < 0 Then
             MsgBox "Value must be at least 0.", vbOKOnly
             Exit Sub
          End If
          If numBytes > BUFFSIZE Then
             numBytes = BUFFSIZE
          End If
          ReDim bArray(numBytes)  'Build the return buffer
    
          'Call CallNamedPipe to do the transaction all at once
          res = CallNamedPipe(szPipeName, numBytes, LenB(numBytes), _
             bArray(0), numBytes, _
             cbRead, 30000) 'Wait up to 30 seconds for a response
    
          If res > 0 Then
             temp = Format(bArray(0), " 000")
             For i = 1 To cbRead - 1
                If (i Mod 16) = 0 Then temp = temp & vbCrLf
                temp = temp & " " & Format(bArray(i), "000")
             Next i
             txtReceive.Text = temp
          Else
             MsgBox "Error number " & Err.LastDllError & _
                    " attempting to call CallNamedPipe.", vbOKOnly
          End If
       End Sub
    
    					
  4. Tenha em atenção que se o servidor estiver em execução num computador diferente do que o cliente é, tem de alterar a '. ' em szPipeName variável para o nome do computador servidor.
  5. Guarde o formulário. Para testar o código anterior, primeiro iniciar o servidor e clique em qualquer ponto do formulário. A aplicação de servidor é agora o bloqueio e parecerão ter desligado, mas na realidade, está à espera para o cliente ligar. Em seguida, inicie a aplicação cliente e clique em Encaminhamento (pipe de "chamada com o nome)." O cliente deve enviar o valor 500 no servidor, irá responder com 500 bytes de dados. Pode definir o valor na caixa de texto cbBytes de 0 para bytes 20000. Para parar o servidor, envie simplesmente 0 (zero) a partir do cliente. O cliente poderá receber o erro 233 (ERROR_PIPE_NOT_CONNECTED), mas isto é normal.

    Outro melhoramento para o exemplo pode incluir a utilização de portas de conclusão de E/S e/ou bloqueio não lê e escritas de E/S sobrepostas a utilizar. Pode encontrar mais informações sobre estes assuntos no Microsoft Platform SDK.

Referências

Existem vários métodos de InterProcess Communication (IPC) disponíveis no Windows 2000, Windows NT e Windows 95 que permitem a transferência unidireccional ou bidireccional de dados entre vários processos. Para obter uma lista completa de métodos de IPC disponíveis cada plataforma, consulte o seguinte artigo na base de dados de conhecimento da Microsoft:
95900Comunicação: interprocessual no Windows NT, Windows 95 e Win32s

Propriedades

Artigo: 177696 - Última revisão: 12 de fevereiro de 2007 - Revisão: 2.4
A informação contida neste artigo aplica-se a:
  • Microsoft Visual Basic 4.0 Professional Edition
  • Microsoft Visual Basic 5.0 Professional Edition
  • Microsoft Visual Basic 6.0 Professional Edition
  • Microsoft Visual Basic 4.0 Enterprise Edition
  • Microsoft Visual Basic 5.0 Enterprise Edition
  • Microsoft Visual Basic Enterprise Edition for Windows 6.0
  • Microsoft Windows NT 4.0
  • Microsoft Windows NT 3.51 Service Pack 5
  • Microsoft Windows NT 4.0
  • Microsoft Windows 98 Standard Edition
  • Microsoft Win32 Application Programming Interface
  • the operating system: Microsoft Windows 2000
  • Microsoft Windows 95
  • Microsoft Windows Millennium Edition
Palavras-chave: 
kbmt kbapi kbhowto KB177696 KbMtpt
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: 177696

Submeter comentários

 

Contact us for more help

Contact us for more help
Connect with Answer Desk for expert help.
Get more support from smallbusiness.support.microsoft.com