PRB: Stack Violation Calling 16-Bit DLL with FoxTools

Last reviewed: December 14, 1995
Article ID: Q139070
The information in this article applies to:
  • Microsoft Visual FoxPro for Windows, version 3.0

SYMPTOMS

Using the FOXTOOLS CallFn()function to call a 16-bit DLL and passing a "L" as an argument generates the error "Stack Violation. Please check the parameters." The same function call works well with FoxPro for Windows versions 2.x.

CAUSE

The function is registered and called as follows.

   Int_num=regfn("Fn_init","L","I", "<path to DLL>")
   Int_ret=callfn(int_num,0)

In this call, the "L" parameter, which represents a long argument, is passed to the DLL. The API function expects a short argument, and the stack allocated for the parameter is filled. The "S" argument, which represents a short integer, should be passed instead.

In the version of Foxtools shipped with FoxPro versions 2.x for Windows the "S" argument was not valid. Additionally, the version of Foxtools.fll shipped with Visual FoxPro version 3.0 checks parameters more strictly than previous versions.

RESOLUTION

When registering a function from a 16-bit DLL, pass an "S" instead of an "L" as in this example:

   Int_num=regfn("Fn_init","S","I", "<path to DLL>")
   Int_ret=callfn(int_num,0)

For more information about Foxtools.fll and the syntax you can use, please see the Foxtools.hlp file located in the Vfp\Tools directory.

STATUS

This behavior is by design.

MORE INFORMATION

Steps to Reproduce Behavior

The following example program duplicates the error. To correct it, change the "L" parameter to "S".

   SET LIBRARY TO HOME()+"FOXTOOLS.FLL"            && Locates Foxtools
   hhand=REGFN("WinHelp","ICIC","I")
   LPZFILENAME=HOME()+"FOXHELP.HLP"+CHR(0)
   WCOMMAND=258
   DWDATA="SEARCH()"+CHR(0)
   MYCALL=MAINHWND()
   HELP
   =CALLFN(hhand,MYCALL,LPZFILENAME,WCOMMAND,DWDATA)
   RELEASE HHAND
   SET LIBRARY TO      && Releases Foxtools


Additional reference words: 3.00
KBCategory: kbprg kbprb
KBSubcategory: FxprgFoxtools


THE INFORMATION PROVIDED IN THE MICROSOFT KNOWLEDGE BASE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. MICROSOFT DISCLAIMS ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL, CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. SOME STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES SO THE FOREGOING LIMITATION MAY NOT APPLY.

Last reviewed: December 14, 1995
© 1998 Microsoft Corporation. All rights reserved. Terms of Use.