Page 1 of 2

How create DLL With XHARBOUR

PostPosted: Sun Dec 11, 2005 10:06 pm
by mauricioajordao
HI Friend´s

How create Dll WITH xharbour..

the ILINK32 display error non public Function

PostPosted: Sun Dec 11, 2005 10:30 pm
by Antonio Linares
Mauricio,

What kind of DLL do you want to create ? There are three types:

1. Self contained DLLs: Its an entire EXE built as a DLL.

2. pcode DLLs: Small pcode DLLs accessible from an EXE.

3. Virtual machine DLLs: The entire virtual machine is inside the DLL and the EXE is small and contains just the pcode.

PostPosted: Sun Dec 11, 2005 10:36 pm
by mauricioajordao
THANKS ANTONIO..

i need create one DLL to USING FIVEWIN FUNCTIONS VIA COBOL..

PostPosted: Mon Dec 12, 2005 7:31 am
by Antonio Linares
Mauricio,

Please read this Harbour's doc:

Code: Select all  Expand view
/*
* $Id: windll.txt,v 1.1 2002/12/28 00:32:44 brianhays Exp $
*/

Windows 32-bit DLLs with Harbour code
=====================================

Programs created with Clipper or Harbour are traditionally a
monolithic EXE containing all executable code.  This includes
the Virtual Machine (VM) and the RunTime Library (RTL) as well as
your own code.  Running under Windows (Win32) with Harbour, you
can now also create and use Windows DLLs that contain PRG code.

Harbour supports Win32 DLLs in 3 ways.

  1) Self-contained DLLs containing functions from any platform.
     (These are not what we call a "Harbour.dll", although they may
     be named that. The DLL entry points are different.)
     These have the VM/RTL inside them and can be used by any other
     Windows program. You can create a .lib for static linking,
     or use GetProcAddress as in any standard Win32 DLL.
     Calling Harbour/Prg functions directly is limited to
     those that take no parameters unless you include C functions
     in the DLL that take parameters and then call the PRG-level
     code.

     To do static linking, do this to create the .lib:
        implib harbour.lib harbour.dll
     For the Borland C platform, use that library and import32.lib
     and cw32.lib from Borland, and you are ready to go.

     See contrib\delphi\hbdll for an example of a Delphi program that can
     use all of Harbour's functionality by accessing a self-contained DLL.
     BLD_SDLL.BAT is used there to create the DLL.


  2) PCode EXEs using a Harbour.dll

     A Harbour.dll is designed to be called from a Harbour app.
     A pcode EXE is a small Harbour executable that does not contain the
     VM/RTL. To execute its functions, it must load and access a
     Harbour.dll.
     If you want dynamic linking, then use this to execute a Harbour
     dynamically loaded pcode DLL function or procedure:
        HB_DllDo( <cFuncName> [,<params...>] ) --> [<uResult>]

     This lets you have all your common code in a DLL, and have lots
     of small EXEs that use it.  Realize however that, even though this
     may be a nice way to manage your code, each EXE may
     load its own image of the Harbour.dll into memory at runtime.
     In terms of Windows memory, there may not be a benefit to using pcode
     EXEs over monolithic EXEs. But it may be a worthwhile maintenance
     benefit to have lots of replaceable small exes.

  3) PCode DLLs used from traditional EXEs
     A pcode DLL does not contain the VM/RTL.
     It is a library of Harbour-compiled PRG code that uses the VM/RTL
     of the EXE that calls it.  This has the benefit of having
     replaceable modules in DLLs that don't necessarily require updating
     your EXE.


The following is clipped from a msg by Antonio Linares to the Harbour
developer list explaining some of the details:

Please notice that there are three different Windows DLL entry points:
   + source/vm/
   * maindll.c     Windows self-contained DLL entry point
   * maindllh.c    Windows Harbour DLL entry point  (harbour.dll)
   * maindllp.c    Windows pcode DLL entry point and VM/RTL routing functions

   >    * maindll.c     Windows self-contained DLL entry point
   To produce Harbour code, as DLLs, that may be used
   from other programming languages applications (as VB,
   Delphi, C++, etc...)

   >    * maindllh.c    Windows Harbour DLL entry point  (harbour.dll)
   To produce Harbour.dll, to be just used from small pcode Harbour EXEs

   >    * maindllp.c    Windows pcode DLL entry point and VM/RTL routing
   To produce small pcode DLLs, to be used just from Harbour EXE apps.
   maindllp.c is the entry point for the Harbour pcode DLLs. pcode DLLs
   are quite small DLLs, that just contain pcode and/or C (using extend
   api) functions.

   mainwin.c is the entry point for Windows EXEs, not for DLLs.

   You may use maindll.c, maindllh.c or maindllp.c based on
   your needs.

   If you are looking to build a Harbour.dll, then you must use
   maindllh.c

PostPosted: Mon Dec 12, 2005 10:09 am
by mauricioajordao
THANKS ANTONIO.

I need self-contained DLL´s ..


Thanks Again

mauricio

PostPosted: Mon Dec 12, 2005 10:31 am
by mauricioajordao
Where Search the Delphi Samples ?

PostPosted: Mon Dec 12, 2005 11:30 am
by Antonio Linares

PostPosted: Mon Dec 12, 2005 11:37 am
by mauricioajordao
thanks again , antonio...



mauricio

PostPosted: Mon Dec 12, 2005 12:38 pm
by mauricioajordao
dear antonio,

Bld_sdll.bat using errorsys.c , may I using generate C VIA xharbour With errorsys.prg ...

That´s Right ?

mauricio

PostPosted: Mon Dec 12, 2005 2:32 pm
by mauricioajordao
DEAR antonio..

How call the function MakeIndex() VIA DLL32 Command "fivewin".

Mauricio

PostPosted: Tue Dec 13, 2005 11:40 am
by Antonio Linares
Mauricio,

You should do some little tests and read the docs I provided you, before going for this. It is not very easy and it requires to know well several concepts before implementing it.

The DLL has to be built with a special entry point, not the standard one provided by Harbour. Then the function has to be declared as exported. Finally you need to load the DLL and check if it loads properly. Then you may try to use the function.

PostPosted: Wed Dec 14, 2005 1:50 am
by mauricioajordao
THANKS ANTONIO.

I´M DOING YET , OK


thanks again ,
mauricio

PostPosted: Mon Dec 19, 2005 4:28 pm
by mauricioajordao
Where have Samples More About DLL Xharbour ?

mauricio

PostPosted: Mon Dec 19, 2005 4:40 pm
by Antonio Linares
Mauricio,

You may ask at news://news.xharbour.org also.

FWH provides some samples, but mostly for pcode DLLs in samples\TestDllp.prg

PostPosted: Mon Dec 19, 2005 11:33 pm
by mauricioajordao
Thanks Antonio ..

only ASK , remember PEEK and POKE Basic Comands ..

What command this Xharbour ?


My DLL are Nice..


thanks again