Использование средств WinAPI в Python: практические сценарии

Расширенные примеры использования библиотек Windows в Python

Пример 1: Перечисление окон с получением заголовков (ctypes)

Используется функция EnumWindows с пользовательским callback. Позволяет получить все окна верхнего уровня и их заголовки.

import ctypes
from ctypes import wintypes

WNDENUMPROC = ctypes.WINFUNCTYPE(wintypes.BOOL, wintypes.HWND, wintypes.LPARAM)

def enum_proc(hwnd, lparam):
    length = user32.GetWindowTextLengthW(hwnd) + 1
    buffer = ctypes.create_unicode_buffer(length)
    user32.GetWindowTextW(hwnd, buffer, length)
    if buffer.value:
        print(f'HWND: {hwnd}, Title: {buffer.value}')
    return True

user32 = ctypes.windll.user32
EnumWindows = user32.EnumWindows
EnumWindows(WNDENUMPROC(enum_proc), 0)

HWND: 65552, Title: Program Manager
HWND: 197868, Title: Microsoft Visual Studio Code
HWND: 852072, Title: Блокнот - ConsoleWindow.txt
... (список всех окон)

Пояснение: WINFUNCTYPE создаёт вызываемую функцию из Python. EnumWindows вызывает её для каждого окна. GetWindowTextW получает текст заголовка. Важно проверять, что buffer.value не пуст, иначе окно без заголовка.

Пример 2: Создание и удаление ключа реестра (winreg)

Работа с реестром: создаём ветку HKCU\Software\MyApp, записываем значение и удаляем.

import winreg

key = winreg.CreateKey(winreg.HKEY_CURRENT_USER, 'Software\\MyApp')
winreg.SetValueEx(key, 'Version', 0, winreg.REG_SZ, '1.0')
winreg.CloseKey(key)
print('Ключ создан')

key = winreg.OpenKey(winreg.HKEY_CURRENT_USER, 'Software\\MyApp')
value, _ = winreg.QueryValueEx(key, 'Version')
print('Version =', value)
winreg.CloseKey(key)

import win32api
import win32con
win32api.RegDeleteKey(win32con.HKEY_CURRENT_USER, 'Software\\MyApp')
print('Ключ удалён')

Ключ создан
Version = 1.0
Ключ удалён

Пояснение: CreateKey создаёт или открывает существующий ключ. SetValueEx пишет значение. Для удаления используется RegDeleteKey из pywin32. При ошибке доступа требуется запуск от администратора.

Пример 3: Запуск процесса с перенаправлением вывода в памяти (CreateProcess через ctypes)

Создаём процесс cmd.exe, перенаправляем stdout в pipe и читаем вывод без записи на диск.

import ctypes
from ctypes import wintypes

kernel32 = ctypes.windll.kernel32

SA = ctypes.c_void_p
SECURITY_ATTRIBUTES = ctypes.Structure()
ctypes.resize(SECURITY_ATTRIBUTES, ctypes.sizeof(ctypes.c_ulong)*3)
SECURITY_ATTRIBUTES.nLength = ctypes.sizeof(SECURITY_ATTRIBUTES)
SECURITY_ATTRIBUTES.bInheritHandle = True
SECURITY_ATTRIBUTES.lpSecurityDescriptor = None

hRead, hWrite = wintypes.HANDLE(), wintypes.HANDLE()
kernel32.CreatePipe(ctypes.byref(hRead), ctypes.byref(hWrite), ctypes.byref(SECURITY_ATTRIBUTES), 0)

si = STARTUPINFO()
si.cb = ctypes.sizeof(STARTUPINFO)
si.dwFlags = 0x00000001 | 0x00000100  # STARTF_USESHOWWINDOW | STARTF_USESTDHANDLES
si.wShowWindow = 0  # SW_HIDE
si.hStdOutput = hWrite
si.hStdError = hWrite

pi = PROCESS_INFORMATION()

cmd = 'cmd.exe /c dir C:\\'
kernel32.CreateProcessW(None, cmd, None, None, True, 0x08000000, None, None, ctypes.byref(si), ctypes.byref(pi))
kernel32.CloseHandle(hWrite)

buffer = ctypes.create_string_buffer(4096)
bytes_read = wintypes.DWORD()
kernel32.ReadFile(hRead, buffer, 4096, ctypes.byref(bytes_read), None)
output = buffer.raw[:bytes_read.value].decode('cp866')
print(output[:500])

kernel32.CloseHandle(hRead)
kernel32.CloseHandle(pi.hProcess)
kernel32.CloseHandle(pi.hThread)

 Том в устройстве C имеет метку Windows
 Номер тома: 1234-5678

 Содержимое папки C:\
... (первые 500 символов вывода dir)

Пояснение: создаётся анонимный pipe, дескриптор записи передаётся дочернему процессу, родитель читает из дескриптора чтения. После запуска hWrite закрывается, иначе ReadFile не завершится. Работает без всплывающего окна консоли.

Пример 4: Чтение данных из Excel через comtypes

Открываем существующий файл Excel, читаем значение из первой ячейки.

import comtypes.client
import os

xl = comtypes.client.CreateObject('Excel.Application')
xl.Visible = False

book = xl.Workbooks.Open(os.path.abspath('test.xlsx'))
sheet = book.Worksheets(1)

cell_value = sheet.Range('A1').Value
print('Значение в A1:', cell_value)

book.Close(SaveChanges=False)
xl.Quit()

Значение в A1: Привет из comtypes

Пояснение: comtypes автоматически загружает библиотеку типов. Visible=False ускоряет работу. Range('A1') возвращает COM-объект, его свойство Value содержит данные.