Поделиться через


Функция SaferiIsExecutableFileType (winsafer.h)

Функция SaferiIsExecutableFileType определяет, является ли указанный файл исполняемым. Приложения используют эту функцию, чтобы определить, является ли файл исполняемым, и если это так, приложение может принять меры безопасности, чтобы предотвратить вызов ненадежного кода.

Синтаксис

BOOL SaferiIsExecutableFileType(
  [in] LPCWSTR szFullPathname,
  [in] BOOLEAN bFromShellExecute
);

Параметры

[in] szFullPathname

Указатель на строку символов Юникода, завершаемую null, для имени файла. Путь необязателен, так как вычисляется только расширение имени файла. При оценке расширения имени файла регистр не учитывается. Этот параметр не может иметь значение NULL или пустую строку, и указанный файл должен содержать расширение имени файла.

[in] bFromShellExecute

Логическое значение, определяющее, обрабатываются ли .exe файлы как исполняемые файлы для оценки типа файла. Присвойте этому значению значение TRUE , чтобы исключить .exe файлы из оценки, или значение FALSE , чтобы включить их.

Возвращаемое значение

Если функция успешно распознает расширение имени файла как исполняемый тип файла, возвращается значение TRUE.

Если функция завершается сбоем или если szFullPath определяет имя файла с неисправимым расширением, функция возвращает значение FALSE.

Комментарии

Следующие расширения имен файлов являются примерами типов исполняемых файлов. Это не полный список.

  • .bat
  • .cmd
  • .com
  • EXE
  • .js
  • .lnk
  • .pif
  • .pl
  • .shs
  • .url
  • .vbs
Оснастка консоли управления (MMC) политики безопасности (Secpol.msc) определяет, какие расширения считаются исполняемыми типами файлов.

Просмотр или изменение расширений, которые считаются исполняемыми типами файлов

  1. Запустите Secpol.msc.
  2. Разверните раздел Политики ограниченного использования программного обеспечения, а затем дважды щелкните Назначенные типы файлов.
Примечание Чтобы просмотреть страницу свойств Назначенные типы файлов , может потребоваться создать узел Политики ограниченного использования программного обеспечения . Чтобы создать узел Политики ограниченного использования программного обеспечения , следуйте инструкциям, отображаемым при развертывании раздела Политики ограниченного использования программного обеспечения.
 

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header winsafer.h
Библиотека Advapi32.lib
DLL Advapi32.dll
Набор API ext-ms-win-advapi32-safer-l1-1-0 (представлено в Windows 8)