Функция _SQLite_Startup

 ↑  ←  Описание функции


_SQLite_Startup

Загружает SQLite3.dll

#include <SQLite.au3>
_SQLite_Startup([$sDll_Filename = "sqlite3.dll" [, $bUTF8ErrorMsg = False [, $bForceLocal = 0 [, $sPrintCallback = __SQLite_ConsoleWrite()]]]])

Параметры

$sDll_Filename [необязательный] Имя dll-файла
$bUTF8ErrorMsg [необязательный] Принудительное отображение символов UTF8 в ConsoleWrite
$bForceLocal [необязательный] Принуждает использовать локальную DLL, иначе DLL будет загружена из интернета.
$sPrintCallback [необязательный] Строка, имя функции обратного вызова (callback) определяемая пользователем, которая вызывается, когда необходимо отображать диагностические сообщения SQLite. См. примечания.

Возвращаемое значение

Успех:Возвращает путь к SQLite3.dll
Ошибка:Устанавливает @error

Примечания

Требуется SQLite3.dll в @ScriptDir или @SystemDir.

Если в скрипт добавлен SQLite3.dll.au3, то SQLite3.dll будет создан в @SystemDir.
Если не удалось создать, то будет создан временный файл, которые будут удален вызовом _SQLite_Shutdown().

Если $bUTF8ErrorMsg не равен нулю, то выводит сформированную UTF8 строку в консоль.
Это позволяет приложениям как SciTE отображать такие символы при отсутствии настройки output.code.page = 65001.
Это для случая, когда SciTE запущен на не-английской версии, как Vista(fr).

Параметр $sPrintCallback указывает имя функции обратного вызова (callback) определяемую пользователем. Эта функция передаёт единственный параметр, который является отображаемым сообщением. По умолчанию функция обратного вызова __SQLite_ConsoleWrite(). Смотрите эту функцию как пример для создания собственной функции обратного вызова.

См. также

_SQLite_Shutdown

Пример

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

Local $sSQliteDll
$sSQliteDll = _SQLite_Startup() ; Загружает SQLite3.dll
If @error Then
    MsgBox(16, "Ошибка SQLite", "Не удалось загрузить SQLite3.dll")
    Exit -1
EndIf
ConsoleWrite("Версия библиотеки SQLite = " & _SQLite_LibVersion() & @CRLF)
MsgBox(0, "SQLite3.dll загружен", $sSQliteDll)
_SQLite_Shutdown()