SetupGetSourceFileSizeW 関数 (setupapi.h)

  • [アーティクル]

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

SetupGetSourceFileSize 関数は、INF ファイルに一覧表示されているソース ファイルの圧縮されていないサイズを読み取ります。

構文

WINSETUPAPI BOOL SetupGetSourceFileSizeW(
  [in]      HINF        InfHandle,
  [in]      PINFCONTEXT InfContext,
  [in]      PCWSTR      FileName,
  [in]      PCWSTR      Section,
  [in, out] PDWORD      FileSize,
  [in]      UINT        RoundingFactor
);

パラメーター

[in] InfHandle

SourceDisksNames セクションと SourceDisksFiles セクションを含む読み込まれた INF ファイルを処理します。 ユーザーのシステムにプラットフォーム固有のセクションが存在する場合 ( SourceDisksNames.x86 や SourceDisksFiles.x86 など)、プラットフォーム固有のセクションが使用されます。

[in] InfContext

サイズを取得するファイルの コピー セクション内の行のコンテキストへのオプションのポインター。 InfContext が NULL の場合は、FileName パラメーターが使用されます。

[in] FileName

サイズを返すファイル名 (パスなし) を含む null で終わる文字列へのオプションのポインター。 このパラメーターが InfContext と同様に NULL の場合は、Section パラメーターが使用されます。

[in] Section

[ファイルのコピー] セクションの名前を含む null で終わる文字列への省略可能なポインター。 このパラメーターを指定すると、セクションにリストされているすべてのファイルの合計サイズが計算されます。

[in, out] FileSize

指定したファイルのサイズ (バイト単位) を受け取る変数へのポインター。

[in] RoundingFactor

ファイル サイズを丸める場合の省略可能な値。 すべてのファイル サイズは、合計サイズに追加される前に、この数値の倍数に切り上げられます。 丸めは、ファイルが特定のボリューム上で占有する領域をより正確に決定する場合に役立ちます。これは、呼び出し元がクラスター サイズの倍数に切り上げられたファイル サイズを持つことができるためです。 RoundingFactor が指定されていない限り、丸め処理は行われません。

戻り値

関数が成功した場合、戻り値は 0 以外の値になります。

関数が失敗した場合は、0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

省略可能なパラメーター InfContext、 FileName、 および Section の 1 つだけを指定する必要があります。

注意

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

要件

   
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー setupapi.h
Library Setupapi.lib
[DLL] Setupapi.dll

関連項目

関数

概要

SetupGetSourceFileLocation