DllCall
Вызывает функцию из DLL.
DllCall ( "dll", "return type", "function" [, type1, param1 [, type n, param n ]] )
Параметры
dll | Имя файла DLL, например используйте "user32.dll". Также можно использовать указатель полученный от DllOpen() (смотрите примечания). |
return type |
Тип возвращаемого значения функции (смотрите ниже). |
function |
Имя функции вызываемой из DLL, например "MessageBox" или её порядковый номер, например 62. |
type1 |
[необязательный] Тип параметра (смотрите примечания). |
param1 |
[необязательный] Значение параметра (смотрите примечания). |
type n |
[необязательный] Тип n-ого параметра (смотрите примечания). |
param n |
[необязательный] Значение n-ого параметра (смотрите примечания). |
Тип | Описание |
none |
нет значения (только для возвращения типа параметра - эквивалентно void в C) |
BYTE |
беззнаковое 8 битное целое |
BOOLEAN |
беззнаковое 8 битное целое |
short |
16 битное целое |
USHORT |
беззнаковое 16 битное целое |
WORD |
беззнаковое 16 битное целое |
int |
32 битное целое |
long |
32 битное целое |
BOOL |
32 битное целое |
UINT |
беззнаковое 32 битное целое |
ULONG |
беззнаковое 32 битное целое |
DWORD |
беззнаковое 32 битное целое |
INT64 |
64 битное целое |
UINT64 |
беззнаковое 64 битное целое |
ptr |
общий указатель (void *) |
HWND |
дескриптор окна (pointer) |
HANDLE |
дескриптор (pointer) |
float |
число одинарной точности с плавающей точкой |
double |
число двойной точности с плавающей точкой |
INT_PTR, LONG_PTR, LRESULT, LPARAM |
большое целое число, достаточное для хранения указателя при запуске x86 или x64 версии AutoIt. |
UINT_PTR, ULONG_PTR, DWORD_PTR, WPARAM |
беззнаковое большое целое число, достаточное для хранения указателя при запуске x86 или x64 версии AutoIt. |
str |
ANSI строка (минимум выделяется 65536 символа). |
wstr |
UNICODE широкий символ строки (минимум выделяется 65536 символа). |
struct | Структура созданная функцией DllStructCreate() |
* |
Добавьте * в конце другого типа, чтобы передать его ссылкой. Например "int*" передает указатель на тип "int". |
Типы в WINDOWS API | Типы в AutoIt |
LPCSTR/LPSTR |
str |
LPCWSTR/LPWSTR |
wstr |
LPVOID |
ptr |
LPxyz |
xyz* |
HINSTANCE |
handle |
HRESULT |
long |
LONGLONG/LARGE_INTEGER |
INT64 |
ULONGLONG/ULARGE_INTEGER |
UINT64 |
SIZE_T |
ULONG_PTR |
Возвращаемое значение
Успех: | @error = 0. | |
Ошибка: | Устанавливает @error | |
@error: | 1 - невозможно использовать файл DLL, | |
2 неизвестный возвращаемый тип (return type). | ||
3 функция не найдена в файле DLL. | ||
4 неверное количество параметров. | ||
5 неверный параметр. |
Примечания
Если используется имя/путь dll, то DLL автоматически загружается и выгружается в конце вызова. Если вы хотите вручную контролировать загрузку и выгрузку DLL, тогда используйте функции DllOpen и DllClose и возвращаемый дескриптор вместо имя/путь dll в этой функции.DllCall("SQLite.dll", "int:cdecl", "sqlite3_open", "str", $sDatabase_Filename , "long*", 0)
См. также
DllCallbackFree, DllCallbackGetPtr, DllCallbackRegister, DllOpen, DllClose, DllStructCreate, DllStructGetPtrПример
; Пример 1 - вызов непосредственно MessageBox API
$result = DllCall("user32.dll", "int", "MessageBox", "hwnd", 0, "str", "Некоторый текст", "str", "Такой вот заголовок", "int", 0)
; Пример 2 - вызов функции, которая запрашивает параметры (запустите блокнот)
$hwnd = WinGetHandle("[CLASS:Notepad]")
$result = DllCall("user32.dll", "int", "GetWindowText", "hwnd", $hwnd, "str", "", "int", 32768)
MsgBox(4096, "", _
$result[0] & @LF & _ ; количество возвращаемых символов
$result[2]) ; текст заголовка возвращаемый в параметре 2
; Пример 3 - Отображает окно выбора иконок PickIconDlg
$sFileName = @SystemDir & '\shell32.dll'
; Создаёт структуру для хранения индекса иконки
$stIcon = DllStructCreate("int")
$stString = DllStructCreate("wchar[260]")
$structsize = DllStructGetSize($stString) / 2
DllStructSetData($stString, 1, $sFileName)
; Вызывает функцию PickIconDlg из shell32.dll с порядковым номером 62 для этой функции
$aRes = DllCall("shell32.dll", "int", 62, "hwnd", 0, "ptr", DllStructGetPtr($stString), "int", $structsize, "ptr", DllStructGetPtr($stIcon))
If @error Or Not $aRes[0] Then Exit ; Выход в случае нажатия кнопки "Отмена"
$sFileName = DllStructGetData($stString, 1)
$nIconIndex = DllStructGetData($stIcon, 1)
; Отображает выбранные имя файла и номер иконки
MsgBox(4096, "Информация", "Последний выбранный файл: " & $sFileName & @LF & "Индекс иконки: " & $nIconIndex)