Compartir a través de

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 se limita 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 Archivos de nomenclatura, rutas de acceso y espacios de nombres.

Propina

A partir de Windows 10, versión 1607, puedes optar por quitar la limitación del MAX_PATH sin tener que prepending "\\?\". Consulte la sección "Limitación máxima de longitud de ruta de acceso" de Archivos de nomenclatura, 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 siguientes constantes.

Valor 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
 A POSIX: aplicación basada en
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, el último código de error es ERROR_BAD_EXE_FORMAT.

Observaciones

Como alternativa, puede obtener la misma información llamando a la función SHGetFileInfo, pasando la marca de 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 Soportado
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 (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 Conventions for Function Prototypes.

Requisitos

Requisito Valor
cliente mínimo admitido Windows XP [solo aplicaciones de escritorio]
servidor mínimo admitido Windows Server 2003 [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
encabezado de winbase.h (incluya Windows.h)
biblioteca de Kernel32.lib
DLL de Kernel32.dll

Consulte también

funciones de administración de archivos

SHGetFileInfo de

vínculos simbólicos