getBinaryTypeA 函数 (winbase.h)

确定文件是否为可执行 (.exe) 文件，如果是，则由哪个子系统运行可执行文件。

语法

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

[in] lpApplicationName

要确定其可执行类型的文件的完整路径。

默认情况下，名称限制为MAX_PATH个字符。若要将此限制扩展到 32，767 个宽字符，请在路径前面添加“\\？\”。有关详细信息，请参阅命名文件、路径和命名空间。

提示

从 Windows 10 版本 1607 开始，可以选择删除MAX_PATH限制，而无需在前面添加“\\？\”。有关详细信息，请参阅命名文件、路径和命名空间的“最大路径长度限制”部分。

[out] lpBinaryType

指向变量的指针，用于接收由 lpApplicationName 指定的文件的可执行文件类型的相关信息。定义了以下常量。

如果文件是可执行文件，则返回值为非零值。函数设置 lpBinaryType 指向的变量，以指示文件的可执行类型。

如果文件不可执行，或者函数失败，则返回值为零。要获得更多的错误信息，请调用 GetLastError。如果文件是 DLL，则会 ERROR_BAD_EXE_FORMAT最后一个错误代码。

作为替代方法，可以通过调用 SHGetFileInfo 函数，在 uFlags 参数中传递 SHGFI_EXETYPE 标志来获取相同的信息。

符号链接行为 - 如果路径指向符号链接，则使用目标文件。

在 Windows 8 和 Windows Server 2012 中，以下技术支持此函数。

注意

winbase.h 标头将 GetBinaryType 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。将非特定编码别名与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。有关详细信息，请参阅函数原型的约定。