Функция GetBinaryType выясняет, исполняемый ли это файл, и, если это так, то какой это исполняемый файл. Это последнее свойство обуславливает то, какой подсистемой исполняемый файл выполняется.
Синтаксис
BOOL GetBinaryType ( LPCTSTR lpApplicationName, // полный путь к файлу LPDWORD lpBinaryType // информация о бинарном типе ); |
Параметры
lpApplicationName
[in] Указатель на символьную строку с нулем в конце, содержащая полный путь к файлу, двоичный тип которого выясняется.В версии ANSI этой функции, число символов имени ограничивается значением MAX_PATH. Чтобы выйти за пределы этого ограничения до длины равной почти 32767 символам, вызовите Unicode версию функции и присоедините спереди пути "\\?\". Подробную информацию см. статье Именование файлов.
lpBinaryType
[out] Указатель на переменную, которая получит информацию об исполняемом типе файла, указанного параметром lpApplicationName. Ниже перечислены константы определяющие типы.
| Значение | Описание |
|---|---|
| SCS_32BIT_BINARY | 32-разрядное базирующееся на Windows приложение. |
| SCS_64BIT_BINARY | Windows XP: 64-разрядное базирующееся на Windows приложение. |
| SCS_DOS_BINARY | Базирующееся на MS-DOS приложение. |
| SCS_OS216_BINARY | 16-разрядное базирующееся на OS/2 приложение. |
| SCS_PIF_BINARY | PIF-файл, который исполняется базирующимся на MS-DOS приложением. |
| SCS_POSIX_BINARY | Базирующееся на правилах POSIX приложение. |
| SCS_WOW_BINARY | 16-разрядное базирующееся на Windows приложение |
Возвращаемые значения
Если файл исполняется, возвращаемое значение - не нуль. Функция устанавливает переменную, на которую указывает параметр lpBinaryType, чтобы обозначить тип исполняемого файла.
Если функция не находит исполняемых файлов или, если функция завершается ошибкой, величина возвращаемого значения - нуль. Чтобы получить дополнительные данные об ошибке, вызов GetLastError.
Замечания
Как альтернатива, Вы можете получить ту же самую информацию при помощи вызова функции SHGetFileInfo, передавая флажок SHGFI_EXETYPE в параметре uFlags .
Смотри также
Обзор Управление файлами, Функции, используемые в управлении файлами, SHGetFileInfo
|
Размещение и совместимость GetBinaryType |
||
| К |
Windows XP |
Да |
| л |
Windows 2000 Professional |
Да |
| и |
Windows NT Workstation |
Да версии 3.5 и выше |
| е |
Windows Me |
Нет |
| н |
Windows 98 |
Нет |
| т |
Windows 95 |
Нет |
| С |
Windows Server 2003 |
Да |
| е | Windows 2000 Server | Да |
| р | Windows NT Server | Да версии 3.5 и выше |
| в | ||
| е | ||
| р | ||
|
Используемая библиотека |
Kernel32.lib |
|
| Используемая DLL | - | |
| Заголовочный файл | ||
|
- объявлено в |
Winbase.h |
|
| - включено в |
Windows.h |
|
| Unicode |
Нет |
|
| Замечания по платформе |
Не имеется |
|