GetDriveTypeA 関数 (fileapi.h)
ディスク ドライブがリムーバブル、固定、CD-ROM、RAM ディスク、またはネットワークのどのドライブかを特定します。
ドライブが USB 型ドライブかどうかを確認するには、 SetupDiGetDeviceRegistryProperty を 呼び出し、 SPDRP_REMOVAL_POLICY プロパティを指定します。
構文
UINT GetDriveTypeA(
[in, optional] LPCSTR lpRootPathName
);
パラメーター
[in, optional] lpRootPathName
ドライブのルート ディレクトリ。
末尾の円記号が必要です。 このパラメーターが NULL の場合、関数は現在のディレクトリのルートを使用します。
戻り値
戻り値はドライブの種類を指定します。ドライブの種類は、次のいずれかの値になります。
| リターン コード/値 | Description |
|---|---|
|
ドライブの種類を特定できません。 |
|
ルート パスが無効です。たとえば、指定したパスにボリュームがマウントされていません。 |
|
ドライブにはリムーバブル メディアがあります。たとえば、フロッピー ドライブ、サム ドライブ、フラッシュ カード リーダーなどです。 |
|
ドライブに固定メディアがあります。たとえば、ハード ディスク ドライブやフラッシュ ドライブなどです。 |
|
ドライブはリモート (ネットワーク) ドライブです。 |
|
ドライブは CD-ROM ドライブです。 |
|
ドライブは RAM ディスクです。 |
解説
Windows 8 と Windows Server 2012 では、この関数は、次のテクノロジによってサポートされています。
| テクノロジ | サポートされています |
|---|---|
| サーバー メッセージ ブロック (SMB) 3.0 プロトコル | いいえ |
| SMB 3.0 Transparent Failover (TFO) | いいえ |
| スケールアウト ファイル共有 (SO) を使う SMB 3.0 | いいえ |
| クラスターの共有ボリューム ファイル システム (CsvFS) | はい |
| Resilient File System (ReFS) | はい |
SMB では、ボリューム管理機能はサポートされていません。
Note
fileapi.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして GetDriveType を定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
| サポートされている最小のクライアント | Windows XP [デスクトップ アプリ | UWP アプリ] |
| サポートされている最小のサーバー | Windows Server 2003 [デスクトップ アプリのみ | UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | fileapi.h (Windows.h を含む) |
| Library | Kernel32.lib |
| [DLL] | Kernel32.dll |