次の方法で共有

SetupQuerySpaceRequiredOnDriveA 関数 (setupapi.h)

  • [アーティクル]

[この機能は、[要件] セクションに示されているオペレーティング システムで使用できます。 以降のバージョンでは、変更または使用できない場合があります。 SetupAPI は、アプリケーションのインストールに使用されなくなりました。 代わりに、Windows インストーラーを使用してアプリケーション インストーラーを開発します。 SetupAPI は、デバイス ドライバーのインストールに引き続き使用されます。

SetupQuerySpaceRequiredOnDrive 関数は、ディスク領域の一覧を調べて、特定のドライブに一覧表示されているすべてのファイル操作を実行するために必要な領域を決定します。

構文

WINSETUPAPI BOOL SetupQuerySpaceRequiredOnDriveA(
  [in]  HDSKSPC  DiskSpace,
  [in]  PCSTR    DriveSpec,
  [out] LONGLONG *SpaceRequired,
  [in]  PVOID    Reserved1,
  [in]  UINT     Reserved2
);

パラメーター

[in] DiskSpace

ディスク領域リストへのハンドル。

[in] DriveSpec

空き領域情報が返されるドライブを指定する null で終わる文字列へのポインター。

これは、"x:" または "\server\share" の形式である必要があります。

[out] SpaceRequired

関数が成功した場合、このパラメーターは、DriveSpec が指定するドライブのディスク領域の一覧に記載されているすべてのファイル操作を処理するために必要な追加の領域 受け取ります。

SetupQuerySpaceRequiredOnDrive 関数は、ターゲット ドライブ上のファイルの既存のバージョンを確認することによって、ターゲット ドライブに必要な追加の領域を計算します。

たとえば、ファイル操作で 2000 バイトのファイル (FIRST.EXE) がディレクトリ C:\MYPROG にコピーされた場合、SetupQuerySpaceRequiredOnDrive 関数は、そのディレクトリ内の既存のバージョンのファイルを自動的にチェックします。 既存のバージョンの C:\MYPROG\FIRST.EXE のファイル サイズが 500 バイトの場合、その操作に必要なドライブ C に必要な追加の領域は 1500 バイトです。

追加の領域が不要な場合、またはターゲット ドライブ上の領域が解放されている場合は、受け取る値は 0 (ゼロ) または負の数にすることができます。

前の例のFIRST.EXEがドライブ C から削除されている場合、必要な領域の量は 2,000 バイト、またはドライブ C で解放された領域です。

既存のバージョンのファイル サイズが 5,000 バイトの場合、2000 バイトのFIRST.EXEに置き換えるために必要なディスク領域は 3,000 バイトです。

ファイル サイズは、ディスク クラスターの境界に丸められます。

[in] Reserved1

引っ込み思案;は 0 (ゼロ) にする必要があります。

[in] Reserved2

引っ込み思案;は 0 (ゼロ) にする必要があります。

戻り値

関数が成功した場合、戻り値は 0 以外の値であり、SpaceRequired は、現在のディスク領域の一覧に記載されているファイル操作に必要な領域を受け取ります。

関数が失敗した場合、戻り値は 0 (ゼロ) です。 拡張エラー情報を取得するには、GetLastError呼び出します。

リターン コード 形容
ERROR_INVALID_DRIVE
 指定したドライブがディスク領域の一覧にありません。
ERROR_INVALID_HANDLE
 指定した DiskSpace ハンドルが無効です。
ERROR_INVALID_PARAMETER
 指定した DriveSpec 文字列が無効です。

備考

手記

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

必要条件

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

関連項目

Functions

の概要

SetupQueryDrivesInDiskSpaceList の