SaferiIsExecutableFileType function (winsafer.h)
The SaferiIsExecutableFileType function determines whether a specified file is an executable file. Applications use this function to determine whether a file is an executable file, and if it is, then the application can take security precautions to prevent invoking untrustworthy code.
Syntax
BOOL SaferiIsExecutableFileType(
[in] LPCWSTR szFullPathname,
[in] BOOLEAN bFromShellExecute
);
Parameters
[in] szFullPathname
Pointer to a null-terminated Unicode character string for the name of the file. The path is optional because only the file name extension is evaluated. The evaluation of the file name extension is not case-sensitive. This parameter cannot be NULL or an empty string, and the specified file must include a file name extension.
[in] bFromShellExecute
Boolean value that determines whether .exe files are treated as executable files for the file type evaluation. Set this value to TRUE to omit .exe files from the evaluation or to FALSE to include them.
Return value
If the function successfully recognizes the file name's extension as an executable file type, the return value is TRUE.
If the function fails, or if szFullPath identifies a file name with a nonexecutable extension, the function returns FALSE.
Remarks
The following file name extensions are examples of executable file types. This is not a complete list.
- .bat
- .cmd
- .com
- .exe
- .js
- .lnk
- .pif
- .pl
- .shs
- .url
- .vbs
To view or modify the extensions that are considered executable file types
- Run Secpol.msc.
- Expand Software Restriction Policies, and then double-click Designated File Types.
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows XP [desktop apps only] |
Minimum supported server | Windows Server 2003 [desktop apps only] |
Target Platform | Windows |
Header | winsafer.h |
Library | Advapi32.lib |
DLL | Advapi32.dll |
API set | ext-ms-win-advapi32-safer-l1-1-0 (introduced in Windows 8) |