ID do artigo: 106553 - �ltima revis�o: quinta-feira, 15 de julho de 2004 - Revis�o: 2.1

Como gravar DLLs C e chamada-los a partir do Visual Basic

Clique aqui para exibir o artigo traduzido e o artigo original em ingl�s, lado a lado.

Exibir Aviso de Isen��o de Tradu��o Autom�tica

Aviso de Isen��o de Responsabilidade sobre Conte�do do KB Aposentado

Exibir os produtos aos quais esse 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.

Sum�rio

Este artigo descreve como usar DLLs com o Visual Basic. Ele aborda os seguintes problemas:

A se��o

1.0 o que � uma DLL?
1.1 Por que usar uma DLL?
1.2 Anatomia de uma DLL.
1.3 Problemas de gerenciamento de mem�ria DLL.
1.4 Criando uma DLL usando o Visual C++.
DLL de 1.5 exemplo C.

Se��o B

DLLs de chamada 2.0 a partir do Visual Basic.
Par�metros de DLL 2.1.
Solucionando problemas de 2.2.
Programa de chamada do 2.3 exemplo Visual Basic.

Voltar para o in�cio

DLLs (bibliotecas de v�nculo din�mico) s�o um aspecto importante do Windows. Uma DLL cont�m fun��es que o programa execut�vel pode chamar durante a execu��o. Em outras palavras, uma DLL � uma biblioteca de fun��es que seu programa pode vincular com dinamicamente.

Um link pode ser est�tico ou din�mico. V�nculos est�ticos n�o s�o alterados. Todas as informa��es endere�o necess�rias por seu programa para acessar a fun��o de biblioteca � fixo quando o arquivo execut�vel � criado e permanece inalterado durante a execu��o.

V�nculos din�micos s�o criados conforme necess�rio. Quando seu programa necessita de uma fun��o que n�o est� no arquivo execut�vel, o Windows carrega a biblioteca de v�nculo din�mico (DLL), disponibilizar todas as suas fun��es para seu aplicativo. Nesse momento, o Windows resolve o endere�o de cada fun��o e links-lo dinamicamente para seu aplicativo.

Todos os controles personalizados usados no Visual Basic s�o DLLs. A �nica diferen�a � que eles exigem tratamento especial em termos de mensagens recebidas a partir do Visual Basic.

1.1 Por que usar DLLs?

Aqui est�o quatro motivos por que voc� deseje usar uma DLL:

Acesso a fun��es de tempo de execu��o C:

A biblioteca de tempo de execu��o C tem muitas fun��es �teis que n�o estaria dispon�veis para programadores de Visual Basic n�o eram para DLLs. Por exemplo, a fun��o _dos_getdiskfree permite que voc� calcular a quantidade total de espa�o em disco e o espa�o livre dispon�vel em uma unidade.
Fun��es de acesso a API (Application Programming Interface) do Windows que requer retorno de chamada rotinas:

Algumas fun��es de API do Windows exigem uma fun��o de retorno de chamada. Uma fun��o de retorno de chamada � uma fun��o que Windows chamar� ao executar a API chamada. Um exemplo desse tipo de fun��o � EnumTaskWindows, que fornecer� a al�a de todas as janelas que pertencem a uma determinada tarefa.
Velocidade:

C � uma linguagem totalmente compilada que funciona em um n�vel est� bastante pr�ximo c�digo de m�quina nativo. Isso significa que a execu��o de programas que s�o bem escrita em C ser� r�pida.
Carregar na utiliza��o:

C�digo e dados de uma DLL s�o carregados somente quando necess�rio. Uma DLL pode ser organizada de modo que somente os componentes necess�rios s�o carregados em oposi��o a DLL inteira. Isso reduz a quantidade de mem�ria necess�ria e o tempo gasto para carregar.

1.2 Anatomia de uma DLL

Cada DLL deve conter uma fun��o LibMain e deve conter um procedimento de sair do Windows (WEP) juntamente com as fun��es exportadas que podem ser chamados por um programa execut�vel.

LibMain:

Uma DLL deve conter a fun��o LibMain. A fun��o LibMain � chamada pelo sistema para inicializar a DLL. LibMain � chamado somente uma vez--quando o primeiro programa que requer a DLL � carregado. Estes s�o os par�metros passados para LibMain:
-HANDLE: Identificador para a inst�ncia da DLL.
-WORD: Segmento de dados da biblioteca.
-WORD: Tamanho de pilha.
-LPSTR: par�metros de linha de comando.
WEP:

O WEP (Procedure de sair do Windows) executa a limpeza para uma DLL antes que a biblioteca seja descarregada. Embora uma fun��o do WEP era necess�ria para cada DLL em vers�es anteriores do sistema operacional Windows, para a vers�o 3.1 � opcional. Um WEP deve ser inclu�do na defini��o de m�dulo arquivo (.def) no Visual C, por exemplo:
EXPORTA��ES
WEP
Exportadas fun��es:

Essas s�o as fun��es que voc� deseja chamar da sua DLL. Eles s�o indicados por _export. _export � usado para compatibilidade com vers�es anteriores. Todas as fun��es que deseja chamar tamb�m devem constar no arquivo (.def) de sua DLL.

Problemas de gerenciamento de mem�ria DLL 1.3

Use o modelo de mem�ria grande.

C armazena todas as vari�veis definidas como est�tica ou global (definido fora de uma fun��o) na pilha do programa espa�o e C armazena todas as outras vari�veis na pilha.

No modelo de pequeno e m�dio, todos os ponteiros s�o pr�ximo por padr�o. Isso significa que os dados s�o acessados por deslocamentos de 16 bits para o registrador de segmento (DS) de dados ou o registrador de segmento (II) de pilha. Infelizmente, o compilador n�o tem como saber se o deslocamento � de servi�o de diret�rio ou o II. Na maioria dos programas esse n�o seria um problema porque o DS e SS aponte para o mesmo segmento. Uma DLL, no entanto, � um caso especial.

Uma DLL tem seu pr�prio segmento de dados, mas compartilha sua pilha com o programa de chamada. Isso significa que o DS e o SS n�o apontam para o mesmo local. A solu��o mais f�cil para esse problema � criar a DLL no modelo de mem�ria grande onde todas as vari�veis s�o referenciadas por um valor de 32 bits.

Por que alocar mem�ria dinamicamente?

Alocar mem�ria dinamicamente � uma t�cnica amig�vel do Windows. Declara��o de matrizes grandes de dados ocupa espa�o na pilha do programa, que � limitada a 64 K, ou segmento de dados do programa, que desperdi�a espa�o em disco e mem�ria do Windows. � melhor para Windows pedir a mem�ria quando voc� precisa dele e liber�-lo quando tiver terminado.

Alocando mem�ria

No Windows, voc� pode alocar dinamicamente dois tipos de mem�ria, local e global. Mem�ria local est� limitada a 64 K e no caso de uma DLL, local de mem�ria � compartilhada com o programa que chamou a DLL. Mem�ria global � toda a mem�ria dispon�vel para o Windows ap�s ele foi carregado.

Local de mem�ria � alocada e gerenciados usando o LocalAlloc, LocalLock LocalUnlock e LocalFree fun��es--como no exemplo:

   char* pszBuffer;
   ....
   pszBuffer = (char *) LocalAlloc (LPTR, 20);
   ...
   LocalFree (pszBuffer);

� mais r�pido alocar a mem�ria local que alocar mem�ria global. Mas aloca��es do heap local s�o limitadas a 64 K, que deve ser compartilhado entre todos os programas que est�o chamando a DLL. � melhor usar a mem�ria local quando pequeno, curtos lived blocos de mem�ria s�o necess�rios.

Global de mem�ria � alocada e gerenciados usando o GlobalAlloc, GlobalLock GlobalUnlock e GlobalFree fun��es--como no exemplo:

   HGLOBAL hglb;
   char* pszBuffer;

   hglb = GlobalAlloc (GHND, 2048);
      // GHND allocates the memory as moveable and
      // initialized to 0
      // 2048 is the amount of memory to be allocated...
   pszBuffer = GlobalLock (hglb);
   ...
   GlobalUnlock (hglb);
   GlobalFree (hglb);

GlobalAlloc A fun��o aloca mem�ria em m�ltiplos de 4 K.

Se voc� quiser compartilhar a mem�ria alocada na DLL com outros programas, voc� deve aloc�-lo usando o sinalizador GMEM_SHARED. Se voc� quiser compartilhar a mem�ria atrav�s de DDE, voc� deve alocar usando o sinalizador GMEM_DDESHARE.

Ser cuidado ao armazenar dados em vari�veis est�ticas

Se voc� tentar armazenar dados em uma DLL usando vari�veis globais ou est�ticas, n�o se surpreenda se esses valores foram alterados quando voc� chama sua DLL em seguida. Os dados armazenados em dessa forma ser�o comuns a todos os aplicativos que acessam essa DLL. N�o importa como muitos aplicativos usam uma DLL, h� apenas uma inst�ncia da DLL. A melhor maneira para contornar esse problema � retornar as estruturas da DLL e pass�-las em novamente quando forem necess�rios.

Identificadores de arquivo

N�o � poss�vel compartilhar identificadores de arquivo entre aplicativos ou DLLs. Cada aplicativo tem sua pr�pria tabela de identificador de arquivo. Para que os dois aplicativos usam o mesmo arquivo usando uma DLL, ele devem ambos abrir o arquivo individualmente.

1.4 Cria��o de uma DLL usando o Visual C++

Aqui est�o as etapas necess�rias para criar uma DLL usando o Visual C++:

Inicie o Visual C++.
Crie um novo projeto, escolha Novo no menu Project. Selecione as seguintes op��es:
- Defina o tipo de projeto como "Windows biblioteca de v�nculo din�mico (.dll)"
- Desmarque a caixa de sele��o "Usar Microsoft Foundation Classes".
Voc� tamb�m pode definir ou exibir essas op��es mais tarde escolhendo Project no menu de op��es.
Adicione os arquivos existentes .C e .def para o projeto, usando a caixa de di�logo que surge quando voc� escolhe Edit a partir do menu Project. Ou insira seu c�digo diretamente na janela de edi��o do Visual C++. (Consulte o c�digo de exemplo .C e .def listado abaixo.)
No menu Project, escolha Build <yourname>.dll op��o.

DLL de 1.5 exemplo C

A seguinte DLL cont�m a fun��o GetDiskInfo, que pode ser chamada a partir do Visual Basic. Ela retornar� o espa�o em disco dispon�vel, o nome atual da unidade e o nome do volume.

      C Code Example, DISKINFO.C:

   #include <windows.h>
   #include <dos.h>

   int CALLBACK LibMain (HANDLE hInstance, WORD wDataSeg, WORD wHeapSize,
   LPSTR lpszCmdLine)

   // The following is required only under Windows version 3.1
   // Win32 does not require or support UnlockData()
   {
      if (wHeapSize > 0)
         UnlockData (0);  //Unlocks the data segment of the library.
      return 1;
   }

   void __export CALLBACK GetDiskInfo (char *cDrive, char *szVolumeName,
   unsigned long *ulFreeSpace)
   {
      unsigned drive;
      struct _diskfree_t driveinfo;
      struct _find_t c_file;

      _dos_getdrive (&drive);
      _dos_getdiskfree( drive, &driveinfo );

      if (!_dos_findfirst( "*.*", _A_VOLID, &c_file ))
         wsprintf( szVolumeName, "%s", c_file.name);
      else
         wsprintf ( szVolumeName, "NO LABEL");

      *cDrive = drive + 'A' -1;

      *ulFreeSpace = (unsigned long) driveinfo.avail_clusters * (unsigned
         long) driveinfo.sectors_per_cluster * (unsigned long)
         driveinfo.bytes_per_sector;
   }

use o seguinte arquivo DISKINFO.DEF no Visual C++:

LIBRARY diskinfo
Descri��o 'GetDiskInfo podem ser chamadas partir do Visual Basic '
EXETYPE WINDOWS 3.1
C�DIGO PRELOAD MOV�VEIS DISCARDABLE
DADOS PRELOAD �NICO M�VEL
HEAPSIZE 4096
EXPORTA��ES
GetDiskInfo @ 1

Observa��o: O nome LIBRARY no arquivo .def deve ser o mesmo que o nome do arquivo DLL, sen�o lhe dar� do Visual Basic "Erro ao carregar DLL". Por exemplo, crie o arquivo DISKINFO.DLL usando a instru��o LIBRARY DISKINFO no arquivo .def acima.

Voltar para o in�cio

SE��O B

DLLs de chamada 2.0 a partir do Visual Basic

No Visual Basic, todas as fun��es, incluindo fun��es DLL, que voc� deseja fazer a chamada deve ser declarado primeiro usando a instru��o Declare. Voc� pode declarar suas fun��es na se��o declara��es de um formul�rio ou um m�dulo. Se voc� declarar um procedimento DLL ou fun��o em um formul�rio, � particular para esse formul�rio. Para tornar p�blica, voc� deve declar�-lo em um m�dulo. A seguir est� um exemplo de instru��o Declare:

   Declare Sub getdiskinfo Lib "c:\somepath\diskinfo.dll"
      (ByVal mydrive As String, ByVal myvolume As String, free As Long)

voc� deve inserir a instru��o Declare toda como um �nica linha. Essa determinada instru��o Declare Declara o procedimento definido pelo usu�rio que GETDISKINFO localizado no usu�rio criado DISKINFO.DLL arquivo.

Depois de declarar a fun��o, voc� pode chamar e usar a fun��o assim como voc� poderia chamar e usar uma fun��o do Visual Basic.

Par�metros DLL 2.1

Como DLLs normalmente s�o escritas em C, DLLs podem usar uma ampla variedade de par�metros n�o diretamente suportado pelo Visual Basic. Como resultado, quando passar par�metros, o programador tem que localizar o tipo de dados apropriado para passar.

Passando argumentos por valor ou por refer�ncia

Por padr�o, o Visual Basic passa todos os argumentos por refer�ncia. (Ao passar por refer�ncia, Visual Basic fornece um endere�o de dist�ncia de 32 bits). No entanto, muitas fun��es DLL esperam um argumento para ser passada por valor. Isso pode ser obtido, colocando a palavra-chave ByVal na frente da declara��o de argumento.

As se��es a seguir mostram como converter par�metros para o Visual Basic.

Par�metros num�ricos de 8 a 16 bits

Passe par�metros de num�ricos de 8 a 16 bits (int, int curto, n�o assinado, unsigned short, BOOL e WORD) como Integer.

Par�metros num�ricos de 32 bits

Passar par�metros num�ricos de 32 bits (tempo, sem sinal longa e DWORD) como LONG.

Identificadores de objeto

Todos os identificadores s�o valores de inteiro de 16 bits exclusivo associados a uma janela e s�o passados por valor, portanto, passar esses par�metros como Integer.

Seq��ncias de caracteres

Seq��ncias de caracteres incluem os tipos de dados LPSTR e LPBYTE (ponteiro para caracteres) ou ponteiro para caracteres n�o assinados. Passe esses par�metros como (ByVal paramname As String). Para passar cadeias de caracteres Visual Basic diretamente, passe-los como (param As String).

Para obter informa��es adicionais sobre passanado seq��ncias entre Visual Basic e um DLL C, consulte o seguinte artigo na Base de dados de Conhecimento da Microsoft:

118643� (http://support.microsoft.com/kb/118643/EN-US/ ) Como passar uma seq��ncia ou seq��ncia de matriz entre VB e C uma DLL

Observa��o: Visual Basic seq��ncias requerem tratamento especial, portanto, n�o passe seq��ncias de caracteres diretamente, a menos que a DLL a exija explicitamente.

Ponteiros para valores num�ricos

Passe ponteiros para valores num�ricos simplesmente n�o utilizando a palavra-chave ByVal.

Estruturas

Se o tipo definido pelo usu�rio do Visual Basic corresponde � estrutura esperada pela DLL, a estrutura pode ser passada por refer�ncia.

Observa��o: Estruturas n�o podem ser passadas por valor.

Ponteiros para matrizes

Passe o primeiro elemento da matriz por refer�ncia.

Ponteiros para fun��es

Visual Basic n�o oferece suporte a fun��es de retorno de chamada, portanto fun��es DLL com ponteiros para fun��es n�o podem ser usadas com o Visual Basic.

Ponteiros nulos

Se uma DLL espera um ponteiro nulo, passe para ele como (ByVal paramname as any). Voc� pode usar 0 & como o valor de paramname ao chamar a DLL.

Solu��o de problemas de 2.2

Abaixo est�o solu��es para alguns problemas que podem ser encontrados.

Recursos do sistema manter ponto inferiores ap�s a DLL � chamada

Se sua DLL est� usando objetos GDI, voc� deve lembrar-se liber�-los ap�s us�-los. Isso n�o pode ser �bvio no Visual Basic, mas quando usando o SDK (software development kit) do Windows se voc� criar um objeto GDI (por exemplo, CreateBrushIndirect), voc� deve exclu�-la usando ExcluirObjeto posteriormente.

Erro de conven��o de chamada de DLL incorreto

Este erro geralmente � causado por omitindo incorretamente ou incluindo a palavra-chave ByVal da instru��o Declare. Este erro tamb�m pode ser causado se errado os par�metros forem passados.

Erro ao carregar DLL

Este erro ocorre quando voc� chamar um procedimento dynamic-link library, biblioteca de v�nculo din�mico e o arquivo especificado na instru��o Declare do procedimento n�o pode ser carregado. Voc� pode usar a fun��o do Microsoft Windows API LoadLibrary para descobrir informa��es mais espec�ficas sobre por que uma DLL Falha ao carregar.

Falha geral de prote��o (GP)

Falhas GP ocorrem quando seu programa grava em um bloco de mem�ria que n�o pertence a ele. Os dois motivos provavelmente para isso s�o:

Overstepped um limite de matriz. C n�o verifica o subscrito de matriz que voc� est� escrevendo a � v�lido. Portanto, voc� pode facilmente escrever para a mem�ria que n�o possui.
Voc� est� usando um ponteiro para um local de mem�ria que voc� tiver liberado. A melhor op��o � atribuir NULL para todos os ponteiros depois de liberar a mem�ria.

Uma falha de diretiva de grupo tamb�m pode ocorrer quando um tipo de vari�vel incorreto � passado para a fun��o DLL.

Programa de chamada do 2.3 exemplo Visual Basic

H� duas partes para chamar uma DLL em um programa do Visual Basic. Primeiro declarar a fun��o, e voc� us�-lo no c�digo do evento.

Eis um exemplo de uma instru��o Declare. A instru��o Declare deve ser colocada em um m�dulo ou em se��o Declara��o geral de um formul�rio.

   ' Enter the following Declare as one, single line:
   Declare Sub getdiskinfo Lib "c:\dllartic\diskinfo.dll"

      (ByVal mydrive As String, ByVal myvolume As String, free As Long)

ByVal especificar instru��es exatamente como mostrado, ou ent�o uma falha de GP pode ocorrer.

Depois que a fun��o � declarada, voc� pode us�-lo no c�digo do evento. O exemplo a seguir usa uma fun��o da DLL no c�digo de evento Click de Command1:

   Sub Command1_Click ()
      Dim drive As String * 1
      Dim volume As String * 20
      Dim free As Long
      Call getdiskinfo(drive, volume, free)
      Text1.Text = drive
      Text2.Text = volume
      Text3.Text = Str$(free)
   End Sub

Voltar para o in�cio

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

Microsoft Visual Basic 3.0 Professional Edition
Microsoft Visual Basic 3.0 Professional Edition

Voltar para o in�cio

kbmt kbhowto kbprogramming KB106553 KbMtpt

Voltar para o in�cio

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 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: 106553� (http://support.microsoft.com/kb/106553/en-us/ )

Voltar para o in�cio

Aviso de Isen��o de Responsabilidade sobre Conte�do do KB Aposentado

Este artigo trata de produtos para os quais a Microsoft n�o mais oferece suporte. Por esta raz�o, este artigo � oferecido "como est�" e n�o ser� mais atualizado.

Voltar para o in�cio

This site in other countries/regions:

Como gravar DLLs C e chamada-los a partir do Visual Basic

Nesta p�gina

Sum�rio

A se��o

Se��o B

Mais Informa��es

UMA SE��O

1.0 o que � uma DLL?

1.1 Por que usar DLLs?

1.2 Anatomia de uma DLL

Problemas de gerenciamento de mem�ria DLL 1.3

Por que alocar mem�ria dinamicamente?

Alocando mem�ria

Ser cuidado ao armazenar dados em vari�veis est�ticas

Identificadores de arquivo

1.4 Cria��o de uma DLL usando o Visual C++

DLL de 1.5 exemplo C

SE��O B

DLLs de chamada 2.0 a partir do Visual Basic

Par�metros DLL 2.1

Passando argumentos por valor ou por refer�ncia

Par�metros num�ricos de 8 a 16 bits

Par�metros num�ricos de 32 bits

Identificadores de objeto

Seq��ncias de caracteres

Ponteiros para valores num�ricos

Estruturas

Ponteiros para matrizes

Ponteiros para fun��es

Ponteiros nulos

Solu��o de problemas de 2.2

Recursos do sistema manter ponto inferiores ap�s a DLL � chamada

Erro de conven��o de chamada de DLL incorreto

Erro ao carregar DLL

Falha geral de prote��o (GP)

Programa de chamada do 2.3 exemplo Visual Basic

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

Palavras-chave:�

Outros Sites de Suporte

Comunidades

Obtenha Ajuda Agora

Tradu��es deste artigo