Función GetBinaryTypeA (winbase.h)

  • Artículo

Determina si un archivo es un archivo ejecutable (.exe) y, si es así, qué subsistema ejecuta el archivo ejecutable.

Sintaxis

BOOL GetBinaryTypeA(
  [in]  LPCSTR  lpApplicationName,
  [out] LPDWORD lpBinaryType
);

Parámetros

[in] lpApplicationName

Ruta de acceso completa del archivo cuyo tipo ejecutable se va a determinar.

De forma predeterminada, el nombre está limitado a MAX_PATH caracteres. Para ampliar este límite a 32 767 caracteres anchos, anteponga "\\?\\ " a la ruta de acceso. Para obtener más información, vea Nomenclatura de archivos, rutas de acceso y espacios de nombres.

Sugerencia

A partir de Windows 10, versión 1607, puede optar por quitar la limitación de MAX_PATH sin prepending "\\?\". Consulte la sección "Limitación máxima de longitud de ruta de acceso" de Nombres de archivos, rutas de acceso y espacios de nombres para obtener más información.

[out] lpBinaryType

Puntero a una variable para recibir información sobre el tipo ejecutable del archivo especificado por lpApplicationName. Se definen las constantes siguientes.

Value Significado
SCS_32BIT_BINARY
0
 Una aplicación basada en Windows de 32 bits
SCS_64BIT_BINARY
6
 Una aplicación basada en Windows de 64 bits.
SCS_DOS_BINARY
1
 Una aplicación basada en MS-DOS
SCS_OS216_BINARY
5
 Una aplicación basada en sistema operativo o 2 de 16 bits
SCS_PIF_BINARY
3
 Un archivo PIF que ejecuta una aplicación basada en MS-DOS
SCS_POSIX_BINARY
4
 Una aplicación basada en POSIX
SCS_WOW_BINARY
2
 Una aplicación basada en Windows de 16 bits

Valor devuelto

Si el archivo es ejecutable, el valor devuelto es distinto de cero. La función establece la variable a la que apunta lpBinaryType para indicar el tipo ejecutable del archivo.

Si el archivo no es ejecutable o si se produce un error en la función, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError. Si el archivo es un archivo DLL, se ERROR_BAD_EXE_FORMAT el último código de error.

Observaciones

Como alternativa, puede obtener la misma información llamando a la función SHGetFileInfo y pasando la marca SHGFI_EXETYPE en el parámetro uFlags .

Comportamiento de vínculo simbólico: si la ruta de acceso apunta a un vínculo simbólico, se usa el archivo de destino.

En Windows 8 y Windows Server 2012, esta función es compatible con las siguientes tecnologías.

Tecnología Compatible
Protocolo bloque de mensajes del servidor (SMB) 3.0 Sí
Conmutación por error transparente (TFO) de SMB 3.0 Sí
SMB 3.0 con recursos compartidos de archivos de escalabilidad horizontal (SO) Sí
Sistema de archivos de volumen compartido de clúster (CsvFS) Sí
Sistema de archivos resistente a errores (ReFS) Sí
 

Nota

El encabezado winbase.h define GetBinaryType como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

   
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 winbase.h (incluye Windows.h)
Library Kernel32.lib
Archivo DLL Kernel32.dll

Vea también

Funciones de administración de archivos

SHGetFileInfo

Vínculos simbólicos