Интеграция Python с COM объектами Windows

Раздел: Системное программирование -> Взаимодействие с Windows COM

Основные подходы к работе с COM в Python

COM (Component Object Model) позволяет программам на разных языках обмениваться данными и вызывать функции друг друга. В Python наибольшее распространение получила библиотека pywin32 (win32com.client). Также существуют альтернативы: comtypes (лёгкая, без лишних зависимостей) и низкоуровневое взаимодействие через ctypes. Ниже рассмотрен основной способ, а затем варианты для разных задач.

Работа с COM через win32com.client (наиболее эффективное решение)

Библиотека pywin32 предоставляет модуль win32com.client для позднего и раннего связывания. Она устанавливается командой:

pip install pywin32

Python работа с com (работа с com в python)

Позднее связывание (без типов) удобно для быстрых скриптов: вы просто передаёте ProgID или CLSID объекта. Пример открытия Excel и заполнения ячейки:

import win32com.client as win32
excel = win32.Dispatch("Excel.Application")
excel.Visible = False
wb = excel.Workbooks.Add()
ws = wb.Worksheets(1)
ws.Cells(1, 1).Value = "Hello from Python"
wb.SaveAs(r"C:\temp\test.xlsx")
excel.Quit()

Пояснение: Dispatch создаёт COM-объект, методы и свойства доступны по имени. После завершения работы следует закрыть приложение, иначе процессы останутся в памяти.

Типичная проблема: объект не создаётся (ошибка "Invalid class string")

Возникает, если указан неверный ProgID или COM-компонент не зарегистрирован в системе. Проверьте реестр (раздел HKEY_CLASSES_ROOT\CLSID) или используйте win32com.client.Dispatch с CLSID в формате "{...}".

Проблема: EXCEL не завершается после Quit

Иногда процесс Excel.exe остаётся в памяти. Решение: явно вызывать excel.Application.Quit() и затем excel = None. Также помогает сборка мусора:import gc; gc.collect().

Для раннего связывания (с типами, IntelliSense) используется win32com.client.DispatchWithEvents или генерация обёрток через makepy.py. Пример регистрации события:

class ExcelEvents:
    def OnSheetActivate(self, Sh):
        print("Активирован лист:", Sh.Name)

excel = win32.DispatchWithEvents("Excel.Application", ExcelEvents)
excel.Visible = True

Как вызвать метод COM объекта, если он описан только в IDL и не доступен через Dispatch?

Использование comtypes

Библиотека comtypes позволяет работать с COM без предварительной генерации обёрток, поддерживает интерфейсы, описанные в IDL. Установка:

pip install comtypes

Пример взаимодействия с Internet Explorer:

import comtypes.client as cc
ie = cc.CreateObject("InternetExplorer.Application")
ie.Visible = True
ie.Navigate("https://example.com")
import time
time.sleep(2)
print(ie.LocationName)
ie.Quit()

Пояснение: CreateObject аналогичен Dispatch в win32com. comtypes автоматически загружает типы из реестра.

Проблема: comtypes не видит COM-сервер (ошибка InterfaceNotFound)

Возникает если интерфейс не зарегистрирован в системе или используемая версия библиотеки не поддерживает данный COM-компонент. Проверьте разрядность (x86 vs x64) Python и COM-объекта. Для 64-битных объектов потребуется 64-битная версия Python.

Как получить список всех зарегистрированных COM объектов или отредактировать реестр COM?

Прямое взаимодействие с реестром через ctypes

Для низкоуровневого доступа к COM можно использовать ctypes и функции Windows API (CoInitialize, CoCreateInstance). Это полезно, когда не хочется тащить целую библиотеку или нужно вызвать COM-компонент из памяти (без реестра).

Пример вызова COM-объекта SAPI.SpVoice для синтеза речи:

import ctypes
from ctypes import wintypes

# Инициализация COM
ole32 = ctypes.windll.ole32
ole32.CoInitialize(None)

# CLSID объекта
CLSID_SpVoice = "{96749377-3391-11D2-9EE3-00C04F797396}"
IID_IUnknown = "{00000000-0000-0000-C000-000000000046}"

# Создание объекта
iunknown = ctypes.POINTER(ctypes.c_void_p)()
hr = ole32.CoCreateInstance(
    ctypes.byref(ctypes.create_string_buffer(CLSID_SpVoice.replace('-','').encode())),
    0,
    1,  # CLSCTX_INPROC_SERVER
    ctypes.byref(ctypes.create_string_buffer(IID_IUnknown.replace('-','').encode())),
    ctypes.byref(iunknown)
)
if hr != 0:
    raise Exception(f"Ошибка CoCreateInstance: {hr}")

# Далее через QueryInterface получаем нужный интерфейс...
ole32.CoUninitialize()

Пояснение: этот код низкоуровневый, обычно не используется напрямую, так как pywin32 и comtypes скрывают сложность. Однако он даёт полный контроль.

Проблема: утечка памяти при ручном управлении COM

Если забыть вызвать CoUninitialize или не освободить интерфейсы, процесс может зависнуть. В ctypes нужно явно вызывать Release() для каждого полученного указателя.

Как автоматизировать Word с защитой от открытых диалогов?

Работа с COM-объектами Office с подавлением ошибок

При автоматизации Microsoft Office часто возникают диалоговые окна (например, подтверждение сохранения). Их можно отключить через свойство DisplayAlerts и ScreenUpdating.

import win32com.client as win32
word = win32.Dispatch("Word.Application")
word.Visible = False
word.DisplayAlerts = False  # отключить сообщения
word.ScreenUpdating = False

После завершения работы рекомендуется снова включить эти свойства.

Дополнительные примеры и нестандартные приёмы

В этом разделе приведены расширенные сценарии, демонстрирующие различные аспекты работы с COM в Python.

1. Получение списка всех запущенных COM-объектов (Running Object Table)

Иногда требуется подключиться к уже работающему приложению (например, Excel, уже открытому пользователем). Используется функция GetActiveObject из win32com.client.

Пример 
import win32com.client as win32
try:
    excel = win32.GetActiveObject("Excel.Application")
    print("Подключились к Excel процессу:", excel.Name)
except:
    print("Excel не запущен")
Подключились к Excel процессу: Microsoft Excel

Пояснение: GetActiveObject возвращает объект, если приложение было запущено и зарегистрировано в ROT (Running Object Table). Если приложение не запущено, выбрасывается исключение.

2. Раннее связывание с генерацией обёртки типов (makepy)

Раннее связывание даёт доступ к константам и методам с подсказками (IntelliSense). Генерация делается один раз.

Пример 
# Создать обёртку для Excel (только один раз)
import win32com.client.makepy as makepy
makepy.GenerateFromTypeLibSpec("Microsoft Excel 16.0 Object Library")

После генерации можно использовать библиотеку как обычный модуль:

Пример 
from win32com.client import DispatchEx, constants
excel = DispatchEx("Excel.Application")
wb = excel.Workbooks.Add()
ws = wb.Worksheets(1)
# Константа xlPasteValues теперь доступна
ws.Range("A1").Copy()
ws.Range("A2").PasteSpecial(Paste=constants.xlPasteValues)
(без вывода, копирование и вставка значений)

3. Использование COM через диспетчер распределённых вычислений (DCOM)

Python может обращаться к COM-объектам, запущенным на удалённом компьютере, если настроен DCOM. В win32com это делается указанием имени сервера.

Пример 
import win32com.client as win32
remote_excel = win32.Dispatch("Excel.Application", machine="\\\192.168.1.100")  # имя или IP удалённого ПК
remote_excel.Visible = False
print(remote_excel.Version)
16.0

Пояснение: требуется, чтобы на удалённой машине были разрешены DCOM-соединения и брандмауэр пропускал порты 135, 139, 445 и динамические порты.

Типичная ошибка: DCOM-доступ заблокирован (E_ACCESSDENIED)

Решение: настроить права доступа для пользователя в оснастке dcomcnfg.exe. Убедитесь, что удалённое приложение (например, Excel) запущено с правами, разрешающими удалённое взаимодействие.

4. Взаимодействие с COM-сервером написанным на C++ (in-process DLL)

Если имеется in-process COM-сервер (DLL), его можно загрузить напрямую через ctypes, минуя реестр.

Пример 
import ctypes
from ctypes import wintypes

# Загрузка DLL
my_dll = ctypes.WinDLL(r"C:\path\to\mycom.dll")
# Получение функции DllGetClassObject (для IClassFactory)
DllGetClassObject = my_dll.DllGetClassObject
DllGetClassObject.restype = wintypes.HRESULT
DllGetClassObject.argtypes = [wintypes.LPCGUID, wintypes.LPCGUID, ctypes.c_void_p]

# Далее создание фабрики и экземпляра...
# (подробный код опущен из-за сложности)

Пояснение: этот подход требует глубокого понимания COM-механизмов и структуры интерфейсов. Обычно проще зарегистрировать DLL в реестре и использовать win32com.

5. Отправка COM-сообщений через диспетчер окон (HWND)

Некоторые COM-объекты (например, Internet Explorer) взаимодействуют через оконные сообщения. Можно получить HWND и отправить сообщения через ctypes.

Пример 
import win32com.client as win32
import ctypes

ie = win32.Dispatch("InternetExplorer.Application")
ie.Visible = True
hwnd = ie.HWND  # дескриптор окна
# Например, закрыть окно через WM_CLOSE
WM_CLOSE = 0x0010
ctypes.windll.user32.SendMessageW(hwnd, WM_CLOSE, 0, 0)
(окно закрывается)

Пояснение: такой способ может спасти, если COM-объект не предоставляет метода Quit() или он блокируется модальным диалогом.

Работа с COM в Python - comments

En
Python работа с com (python)