DllLoad()

Allgemeines

Mit der Funktion DllLoad() wird eine externe DLL für die Verwendung in Xbase++ geladen. Es kann sich dabei um eine dynamische Xbase++ DLL oder auch um eine beliebige, andere 32bit Windows DLL handeln.

Die Funktion DllLoad() erlaubt bei dynamischen Xbase++ DLLs zusätzliche Einstellungen.

Syntax

DllLoad( <cDllName> [, <cFuncPrefix> ] [, <lSuppressInitExit>] ) --> nDllHandle

Parameter

cDllName - Name der DLL, die geladen werden soll. Es wird nur der Name der DLL ohne Pfad angegeben! Das Suchschema wird durch Windows festgelegt.

spezifische Parameter für dynamische Xbase++ DLLs

cFuncPrefix - definiert ein Präfix, das den in der DLL definierten Funktion vorangestellt werden soll, z.B. um Kollisionen mit im Programm definierten Funktionsnamen zu verhindern.

lSuppressInitExit - innerhalb einer Xbase++ Programmquelle können sogenannte INIT PROCEDUREs und EXIT PROCEDUREs definiert werden, die beim Start bzw. Programmende ausgeführt werden. Wird dieser Parameter mit dem Wert TRUE (.T.) angegeben, werden in der DLL definierte INIT PROCEDUREs und EXIT PROCEDUREs nicht ausgeführt.

Rückgabewert

nDllHandle - wenn der Rückgabewert grösser ist als 0, wurde die DLL erfolgreich geladen und kann über den Wert in nDllHandle im Programm referenziert werden.

Querverweise

DllCall()

DllPrepareCall()

DllUnload()

benötigte DLLs bzw. Include-Dateien

Dll.CH

XbpRT1.DLL