GetDiskFreeSpaceExA 関数 (fileapi.h)
ディスク ボリュームで使用可能な領域の量 (合計領域、空き領域の合計、呼び出し元スレッドに関連付けられているユーザーが使用できる空き領域の合計) に関する情報を取得します。
構文
BOOL GetDiskFreeSpaceExA(
[in, optional] LPCSTR lpDirectoryName,
[out, optional] PULARGE_INTEGER lpFreeBytesAvailableToCaller,
[out, optional] PULARGE_INTEGER lpTotalNumberOfBytes,
[out, optional] PULARGE_INTEGER lpTotalNumberOfFreeBytes
);
パラメーター
[in, optional] lpDirectoryName
ディスク上のディレクトリ。
このパラメーターが NULL
このパラメーターが UNC 名の場合は、末尾の円記号 ("\\MyServer\MyShare\" など) を含める必要があります。
このパラメーターは、ディスク上のルート ディレクトリを指定する必要はありません。 この関数は、ディスク上の任意のディレクトリを受け入れます。
呼び出し元のアプリケーションには、この FILE_LIST_DIRECTORY アクセス権が必要です。
ディレクトリ。
[out, optional] lpFreeBytesAvailableToCaller
呼び出し元のスレッドに関連付けられているユーザーが使用できるディスク上の空きバイトの合計数を受け取る変数へのポインター。
このパラメーターは NULL
ユーザーごとのクォータが使用されている場合、この値はディスク上の空きバイトの合計数より小さい可能性があります。
[out, optional] lpTotalNumberOfBytes
呼び出し元スレッドに関連付けられているユーザーが使用できるディスク上の合計バイト数を受け取る変数へのポインター。
このパラメーターは NULL
ユーザーごとのクォータが使用されている場合、この値はディスク上の合計バイト数より小さい可能性があります。
ディスクまたはボリューム上の合計バイト数を確認するには、IOCTL_DISK_GET_LENGTH_INFOを使用します。
[out, optional] lpTotalNumberOfFreeBytes
ディスク上の空きバイトの合計数を受け取る変数へのポインター。
このパラメーターは NULL
戻り値
関数が成功した場合、戻り値は 0 以外です。
関数が失敗した場合、戻り値はゼロ (0) になります。 拡張エラー情報を取得するには、GetLastError
備考
この関数によって取得される値は、ULARGE_INTEGER型です。 これらの値を 32 ビットに切り捨てないでください。
シンボリック リンクの動作 : パスがシンボリック リンクを指している場合、操作はターゲットで実行されます。
手記
fileapi.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして GetDiskFreeSpaceEx を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows XP [デスクトップ アプリ |UWP アプリ] |
| サポートされる最小サーバー | Windows Server 2003 [デスクトップ アプリ |UWP アプリ] |
| ターゲット プラットフォーム の |
ウィンドウズ |
| ヘッダー | fileapi.h (Windows.h を含む) |
| ライブラリ | Kernel32.lib |
| DLL | Kernel32.dll |
関連項目
GetDiskFreeSpace を
GetModuleHandle を