Editing callLib - FilterMeisterWiki

When saving, enter the following:

  _   _    ###    _          ####   ZZZZZZZ 
 | \ | |    #    | \    /\  ##  ##   ZZ   Z 
 |  \| |    #    |  \  / / ##        ZZ     
 | |\  |    #    |  (_/ /  ##        ZZZZZ  
 |_| \_|    #    |   _ (   ##  ###   ZZ     
            #    |  ( \ \   ##  ##   ZZ   Z 
           ###   |  /  \ \   #####  ZZZZZZZ 
                 |_/    \/

Visit Preferences to set your user name

= callLib =
''Requires FM 1.0 Beta 9.0 (April 2008) or newer''

== Syntax ==
{{int callLib(void *fnptr, ...)}}

== Arguments ==
:'''fnptr'''
::A pointer (obtained with ((getLibFn))) to the DLL function to call.
:'''...'''
::The other parameters required by the DLL function (varies depending on the function).

== Return ==
Returns the return value of the called DLL function, which varies depending on the function called.

== Description ==
Calls a function in a DLL that has previously been loaded with ((loadLib)) and ((getLibFn)).

== Example ==
<code>
// This code loads the user32.dll
// DLL included with Windows and
// uses it to display a YES/NO
// Message Box.

int* lib_user32;
int* functionPointer;
int returnval;

// Load the DLL library
lib_user32 = loadLib("user32");
if (lib_user32) {

// Get the function in the DLL
  functionPointer = getLibFn(lib_user32, "MessageBoxA");
  if (functionPointer) {

// Call the function
    strcpy(str0, "The window text is here");
    strcpy(str1, "Caption Text");
    returnval = callLib(functionPointer, NULL, str0, str1, MB_YESNO);

// Process return value
    if (returnval == IDYES)
      msgBox(MB_OK, "Yes!", "Yes was clicked");
    if (returnval == IDNO)
      msgBox(MB_OK, "No :(", "No was clicked");

}
  else msgBox(MB_OK, "Error", "Function wasn't loaded");

// Free the library DLL
  freeLib(lib_user32);

}
else msgBox(MB_OK, "Error", "DLL was not loaded");
</code>

== See Also ==
((loadLib)), ((getLibFn)), ((freeLib)), ((fCallLib))

== Comments ==
:Everyone can add their comments about their experiences with this function here. Tips for using it are welcome, too.

Summary of change:
Add document to category: