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 ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして GetDriveType を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件	価値
サポートされる最小クライアント	Windows XP [デスクトップ アプリ |UWP アプリ]
サポートされる最小サーバー	Windows Server 2003 [デスクトップ アプリ |UWP アプリ]
ターゲット プラットフォーム の	ウィンドウズ
ヘッダー	fileapi.h (Windows.h を含む)
ライブラリ	Kernel32.lib
DLL	Kernel32.dll

関連項目

GetDiskFreeSpace を する

ボリューム管理機能 の