Compartir a través de

Función SaferiIsExecutableFileType (winsafer.h)

  • Artículo

La función SaferiIsExecutableFileType determina si un archivo especificado es un archivo ejecutable. Las aplicaciones usan esta función para determinar si un archivo es un archivo ejecutable y, si es así, la aplicación puede tomar precauciones de seguridad para evitar invocar código no confiable.

Sintaxis

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

Parámetros

[in] szFullPathname

Puntero a una cadena de caracteres Unicode terminada en null para el nombre del archivo. La ruta de acceso es opcional porque solo se evalúa la extensión de nombre de archivo. La evaluación de la extensión de nombre de archivo no distingue mayúsculas de minúsculas. Este parámetro no puede ser NULL o una cadena vacía, y el archivo especificado debe incluir una extensión de nombre de archivo.

[in] bFromShellExecute

Valor booleano que determina si .exe archivos se tratan como archivos ejecutables para la evaluación del tipo de archivo. Establezca este valor en TRUE para omitir .exe archivos de la evaluación o en FALSE para incluirlos.

Valor devuelto

Si la función reconoce correctamente la extensión del nombre de archivo como un tipo de archivo ejecutable, el valor devuelto es TRUE.

Si se produce un error en la función o si szFullPath identifica un nombre de archivo con una extensión nonexecutable, la función devuelve FALSE.

Comentarios

Las siguientes extensiones de nombre de archivo son ejemplos de tipos de archivo ejecutables. Esta lista no está completa.

  • .bat
  • .cmd
  • .com
  • .exe
  • .js
  • .lnk
  • .pif
  • .pl
  • .shs
  • .url
  • .vbs
La directiva de seguridad Microsoft Management Console (MMC) controla los controles de complemento (Secpol.msc) que extensiones se consideran tipos de archivo ejecutables.

Para ver o modificar las extensiones que se consideran tipos de archivo ejecutable

  1. Ejecute Secpol.msc.
  2. Expanda Directivas de restricción de software y, a continuación, haga doble clic en Tipos de archivo designados.
Nota Para ver la página de propiedades Tipos de archivo designados , es posible que tenga que crear el nodo Directivas de restricción de software . Para crear el nodo Directivas de restricción de software , siga las instrucciones que aparecen al expandir Directivas de restricción de software.
 

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado winsafer.h
Library Advapi32.lib
Archivo DLL Advapi32.dll
Conjunto de API ext-ms-win-advapi32-safer-l1-1-0 (introducido en Windows 8)