共用方式為


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所指定檔案可執行檔案類型相關資訊的變數指標。 定義下列常數。

意義
SCS_32BIT_BINARY
0
以 32 位 Windows 為基礎的應用程式
SCS_64BIT_BINARY
6
以 64 位 Windows 為基礎的應用程式。
SCS_DOS_BINARY
1
MS-DOS – 型應用程式
SCS_OS216_BINARY
5
以 16 位 OS/2 為基礎的應用程式
SCS_PIF_BINARY
3
執行 MS-DOS 型應用程式的 PIF 檔案
SCS_POSIX_BINARY
4
POSIX – 型應用程式
SCS_WOW_BINARY
2
以 16 位 Windows 為基礎的應用程式

傳回值

如果檔案是可執行檔,則傳回值為非零。 函式會設定 lpBinaryType 指向的變數,以指出檔案的可執行檔案類型。

如果檔案不是可執行檔,或函式失敗,則傳回值為零。 若要取得擴充的錯誤資訊,請呼叫 GetLastError。 如果檔案是 DLL,則最後一個錯誤碼 會ERROR_BAD_EXE_FORMAT

備註

或者,您可以呼叫SHGetFileInfo函式,在uFlags參數中傳遞SHGFI_EXETYPE旗標,以取得相同的資訊。

符號連結行為- 如果路徑指向符號連結,則會使用目標檔案。

在Windows 8和Windows Server 2012中,下列技術支援此函式。

技術 支援
伺服器訊息區 (SMB) 3.0 通訊協定 Yes
SMB 3.0 透明容錯移轉 (TFO) Yes
具有向外延展檔案共用的 SMB 3.0 (SO) Yes
叢集共用磁片區檔案系統 (CsvFS) Yes
彈性檔案系統 (ReFS) Yes
 

注意

winbase.h 標頭會將 GetBinaryType 定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程式碼,可能會導致編譯或執行時間錯誤不符。 如需詳細資訊,請參閱 函式原型的慣例

規格需求

   
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平台 Windows
標頭 winbase.h (包含 Windows.h)
程式庫 Kernel32.lib
DLL Kernel32.dll

另請參閱

檔案管理功能

SHGetFileInfo

符號連結