Función GetBinaryTypeA (winbase.h)
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.
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 |