getDriveTypeA 函式 (fileapi.h)

  • 發行項

判斷磁片磁碟機是否為卸載式、固定、CD-ROM、RAM 磁碟或網路磁碟機機。

若要判斷磁片磁碟機是否為 USB 類型磁片磁碟機，請呼叫 SetupDiGetDeviceRegistryProperty 並指定 SPDRP_REMOVAL_POLICY 屬性。

語法

UINT GetDriveTypeA(
  [in, optional] LPCSTR lpRootPathName
);

參數

[in, optional] lpRootPathName

磁片磁碟機的根目錄。

需要尾端反斜線。 如果此參數為 Null，函式會使用目前目錄的根目錄。

傳回值

傳回值會指定磁片磁碟機的類型，可以是下列其中一個值。

傳回碼/值 描述
DRIVE_UNKNOWN
0
 無法判斷磁片磁碟機類型。
DRIVE_NO_ROOT_DIR
1
 根路徑無效;例如，指定的路徑上沒有掛接的磁片區。
DRIVE_REMOVABLE
2
 磁片磁碟機具有卸載式媒體;例如，磁片磁碟機、指紋磁片磁碟機或快閃讀卡機。
DRIVE_FIXED
3
 磁片磁碟機具有固定媒體;例如，硬碟或快閃磁片磁碟機。
DRIVE_REMOTE
4
 磁片磁碟機是遠端 (網路) 磁片磁碟機。
DRIVE_CDROM
5
 磁片磁碟機是 CD-ROM 磁片磁碟機。
DRIVE_RAMDISK
6
 RAM 磁碟。

備註

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

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

SMB 不支援磁片區管理功能。

注意

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

需求

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

另請參閱

GetDiskFreeSpace

磁片區管理功能