Fonction SaferiIsExecutableFileType (winsafer.h)

Article
08/27/2023

La fonction SaferiIsExecutableFileType détermine si un fichier spécifié est un fichier exécutable. Les applications utilisent cette fonction pour déterminer si un fichier est un fichier exécutable, et si c’est le cas, l’application peut prendre des précautions de sécurité pour empêcher l’appel de code non fiable.

Syntaxe

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

Paramètres

[in] szFullPathname

Pointeur vers une chaîne de caractères Unicode terminée par null pour le nom du fichier. Le chemin d’accès est facultatif, car seule l’extension de nom de fichier est évaluée. L’évaluation de l’extension de nom de fichier ne respecte pas la casse. Ce paramètre ne peut pas avoir la valeur NULL ou une chaîne vide, et le fichier spécifié doit inclure une extension de nom de fichier.

[in] bFromShellExecute

Valeur booléenne qui détermine si les fichiers .exe sont traités comme des fichiers exécutables pour l’évaluation du type de fichier. Définissez cette valeur sur TRUE pour omettre .exe fichiers de l’évaluation ou sur FALSE pour les inclure.

Valeur retournée

Si la fonction reconnaît correctement l’extension du nom de fichier en tant que type de fichier exécutable, la valeur de retour est TRUE.

Si la fonction échoue ou si szFullPath identifie un nom de fichier avec une extension non exécutable, la fonction retourne FALSE.

Remarques

Les extensions de nom de fichier suivantes sont des exemples de types de fichiers exécutables. Cette liste n’est pas exhaustive.

.bat
.cmd
.com
.exe
.js
.lnk
.pif
.pl
.shs
.url
.vbs

Le composant logiciel enfichable Microsoft Management Console (MMC) de stratégie de sécurité (Secpol.msc) contrôle les extensions qui sont considérées comme des types de fichiers exécutables.

Pour afficher ou modifier les extensions considérées comme des types de fichiers exécutables

Exécutez Secpol.msc.
Développez Stratégies de restriction logicielle, puis double-cliquez sur Types de fichiers désignés.

Note Pour afficher la page de propriétés Types de fichiers désignés , vous devrez peut-être créer le nœud Stratégies de restriction logicielle . Pour créer le nœud Stratégies de restriction logicielle , suivez les instructions qui s’affichent lorsque vous développez Stratégies de restriction logicielle.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winsafer.h
Bibliothèque	Advapi32.lib
DLL	Advapi32.dll
Ensemble d’API	ext-ms-win-advapi32-safer-l1-1-0 (introduit dans Windows 8)

Partager via