UDF > SQLite >

_SQLite_Startup

Charge SQLite3.dll

#include <SQLite.au3>
_SQLite_Startup ( [$sDll_Filename = "" [, $bUTF8ErrorMsg = False [, $iForceLocal = 0 [, $hPrintCallback = $__g_hPrintCallback_SQLite]]]] )

Param�tres

$sDll_Filename [optionnel] Nom du fichier DLL. Par d�faut "sqlite3.dll" ou "sqlite3_x64.dll" en mode X64.
$bUTF8ErrorMsg [optionnel] Pour forcer ConsoleWrite() � afficher les caract�res UTF8
$iForceLocal [optionnel] 1 = utilise le fichier DLL d�fini. Aucune v�rification de version. "_x64.dll" automatiquement en mode X64.
0 = la DLL sera t�l�charg�e si non trouv�e dans @ScriptDir, @SystemDir, @WindowsDir et @WorkingDir.
-1 = force le t�l�chargement
$hPrintCallback [optionnel] Une variable contenant une fonction d�finie par l'utilisateur pour afficher un message de diagnostic SQLite. Par d�faut = __SQLite_ConsoleWrite(). Voir Remarques.

Valeur de retour

Succ�s: Retourne le chemin du fichier DLL ouvert.
�chec: D�finit @error <> 0.

Remarques

Si #include <SQLite.dll.au3> est utilis� la version de SQLite est test�e. Si elle est obsol�te, elle est t�l�charg�e.

Le fichier t�l�charg� sera cr�� dans @SystemDir (peut n�cessiter #RequireAdmin).
Si la cr�ation n'est pas r�ussie, un fichier temporaire sera cr�� et il sera d�truit lorsque _SQLite_Shutdown() sera appel�e.

Si $bUTF8ErrorMsg n'est pas z�ro, les cha�nes format�es UTF8 s'affichent dans la console.
Cela permet aux applications, tel que SciTE, d'afficher ces caract�res si elles sont configur�es avec output.code.page = 65001.
C'est le cas lors de l'ex�cution SciTE sous une version qui n'est pas en anglais comme Vista(fr).

Le param�tre $hPrintCallback sp�cifie le nom de la fonction de rappel d�finie par l'utilisateur. Cette fonction sera pass�e avec un seul param�tre qui sera le message � afficher. La fonction de rappel par d�faut est $__g_hPrintCallback_SQLite. Voir cette fonction pour un exemple de mise en œuvre de votre propre fonction de rappel.

En relation

_SQLite_Shutdown

Exemple

Exemple 1

; La version SQLite.dll doit �tre trouv�e

#include <MsgBoxConstants.au3>
#include <SQLite.au3>
#include <SQLite.dll.au3>

Local $sSQliteDll = _SQLite_Startup()

If @error Then
    MsgBox($MB_SYSTEMMODAL, "SQLite Error", "SQLite3.dll ne peut pas �tre charg�!" & @CRLF & @CRLF & _
            "NON trouv� dans @SystemDir, @WindowsDir, @ScriptDir, @WorkingDir, ou sur le site www.autoitscript.com")
    Exit -1
EndIf

MsgBox($MB_SYSTEMMODAL, "SQLite3.dll charg�", $sSQliteDll & " (" & _SQLite_LibVersion() & ")")
ConsoleWrite("_SQLite_LibVersion=" & _SQLite_LibVersion() & @CRLF)
_SQLite_Shutdown()

Exemple 2

; Aucune version ne doit exister dans @SystemDir, @WindowsDir, @ScriptDir ou @WorkingDir

#include <MsgBoxConstants.au3>
#include <SQLite.au3>

Local $sSQliteDll
$sSQliteDll = _SQLite_Startup()
If @error Then
    MsgBox($MB_SYSTEMMODAL, "SQLite Error", "SQLite3.dll ne peut pas �tre charg�!" & @CRLF & @CRLF & _
            "NON trouv� dans @SystemDir, @WindowsDir, @ScriptDir or @WorkingDir")
    Exit -1
EndIf

MsgBox($MB_SYSTEMMODAL, "SQLite3.dll Loaded", $sSQliteDll & " (" & _SQLite_LibVersion() & ")")
ConsoleWrite("_SQLite_LibVersion=" & _SQLite_LibVersion() & @CRLF)
_SQLite_Shutdown()

Exemple 3

; Ouvre SQLite avec un fichier local pr�cis�

#include <MsgBoxConstants.au3>
#include <SQLite.au3>

Local $sLocalSQLiteDll = "local SQLite.dll" ; Est chang�e en un .dll existant pour ne pas avoir d'erreur

Local $sSQliteDll = _SQLite_Startup($sLocalSQLiteDll, False, 1)
If @error Then
    MsgBox($MB_SYSTEMMODAL, "SQLite Error", "'SQLite3.dll' Ne peut pas �tre charg�e!")
    Exit -1
EndIf

MsgBox($MB_SYSTEMMODAL, "SQLite3.dll Loaded", $sSQliteDll & " (" & _SQLite_LibVersion() & ")")
ConsoleWrite("_SQLite_LibVersion=" & _SQLite_LibVersion() & @CRLF)
_SQLite_Shutdown()

Exemple 4

; Force le t�l�chargement � partir de  www.autoitscript.com

; #RequireAdmin ; N�cessaire si le fichier se trouve dans @systemdir o� il est recherch�

#include <MsgBoxConstants.au3>
#include <SQLite.au3>
#include <SQLite.dll.au3>

Local $sSQliteDll = _SQLite_Startup("", False, -1)
If @error Then
    MsgBox($MB_SYSTEMMODAL, "SQLite Error", "'SQLite3.dll' ne peut pas �tre charg�e!")
    Exit -1
EndIf

MsgBox($MB_SYSTEMMODAL, "SQLite3.dll Loaded", $sSQliteDll & " (" & _SQLite_LibVersion() & ")")
ConsoleWrite("_SQLite_LibVersion=" & _SQLite_LibVersion() & @CRLF)
_SQLite_Shutdown()