STRUCTUREцифровые системыОбсудить проект
НОВОСТЬ · Engineering

Инженер Microsoft объяснил, почему таблицы совместимости Windows API не исчерпывающие

Рэймонд Чен из команды Windows уточнил смысл таблиц поддержки файловых систем и сетевых протоколов в Microsoft Learn. Если технологии нет в списке для конкретной операции, это не равнозначно запрету: документация отражает только подтверждённые Microsoft сведения.

Иллюстрация из открытой ленты Habr

Главное

Поводом для разъяснения стала распространённая ошибка при чтении справочника Windows API. В разделе Remarks у некоторых файловых функций приведена таблица с поддерживаемыми файловыми системами и сетевыми технологиями. Разработчики иногда воспринимают такой перечень как полный, хотя инженер Microsoft Рэймонд Чен пояснил в своём блоге The Old New Thing, что он ограничен имеющейся у компании информацией.

В официальном описании функции GetVolumeInformationByHandleW есть наглядный пример: для нескольких вариантов протокола SMB 3.0 указано «No», а для CsvFS и ReFS — «Yes». Это конкретные статусы применительно к конкретной операции и контексту документации, а не оценка возможностей перечисленных технологий вообще. Явное «No» сообщает об отсутствии заявленной поддержки, а отсутствие строки не даёт готового ответа.

Подробности

Чен обращает внимание на разнообразие сторонних файловых систем и сетевых протоколов. Их разработчики могут реализовывать интерфейсы, о которых документация Windows не располагает достаточно полными сведениями. Поэтому Microsoft не обещает перечислить все существующие варианты совместимости. Неупомянутая реализация может работать, но это необходимо устанавливать по технической документации её поставщика и результатам проверок.

Для команд, создающих приложения хранения данных и инструменты администрирования, нюанс имеет практическое значение. Нельзя автоматически исключать драйвер только потому, что его название не встречается в таблице. Равно опасно предполагать, что неуказанная система обязательно совместима. Корректная проверка начинается с нужной функции API, версии Windows, конкретного протокола и поведения продукта в целевой среде.

Что это меняет

Разъяснение не является объявлением новой функциональности Windows и не меняет существующие договорённости о поддержке драйверов. Оно уточняет способ толкования справочных таблиц: положительный и отрицательный ответ имеют значение, а пустое место оставляет вопрос открытым. Для разработчиков это повод отделять задокументированную гарантию от самостоятельно проверенной совместимости и фиксировать результаты собственных тестов.

Первоисточник

Материал подготовлен STRUCTURE по открытой публикации Habr. Текст и иллюстрации первоисточника не воспроизводятся целиком.

Читать исходную новость целиком ↗