SetupInstallFilesFromInfSectionA 関数 (setupapi.h)

[アーティクル]
03/15/2023

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

SetupInstallFilesFromInfSection 関数は、[ファイルのコピー]、[ファイルの削除]、および [ファイルの名前の変更] セクションで指定されたインストール用のすべてのファイルをキューに入れます。このセクションは、Install セクションで一覧表示されます。

ファイルが変更された場合、この関数の呼び出し元は、ターゲットディレクトリに書き込む権限を持っている必要があります。

構文

WINSETUPAPI BOOL SetupInstallFilesFromInfSectionA(
  [in] HINF     InfHandle,
  [in] HINF     LayoutInfHandle,
  [in] HSPFILEQ FileQueue,
  [in] PCSTR    SectionName,
  [in] PCSTR    SourceRootPath,
  [in] UINT     CopyFlags
);

パラメーター

[in] InfHandle

インストールするセクションを含む INF ファイルへのハンドル。

[in] LayoutInfHandle

SourceDisksFiles セクションと SourceDisksNames セクションを含む INF ファイルへのハンドルへの省略可能なポインター。

LayoutInfHandle が指定されていない場合は、InfHandle の SourceDisksFiles セクションと SourceDisksNames セクションが使用されます。

[in] FileQueue

インストール操作を追加するキューへのハンドル。

[in] SectionName

インストールするファイルを含む [ファイルのコピー]、[ファイルの削除]、および [ファイルの名前変更] セクションを一覧表示する InfHandle パラメーターの [インストール] セクションの名前。

null で終わる文字列を使用します。

[in] SourceRootPath

コピーするソースファイルへのルートパスへの省略可能なポインター (A:\ や \pegasus\win\install など)。

null で終わる文字列を使用します。

[in] CopyFlags

ファイルコピー操作の動作を制御するフラグのセットへのオプションのポインター。

フラグには、次の値の組み合わせを指定できます。

SP_COPY_DELETESOURCE

コピータスクが成功したときにソースファイルを削除します。

削除タスクが失敗した場合、呼び出し元には通知されません。

SP_COPY_REPLACEONLY

コピー先のパスにあるファイルを上書きするためにのみ、ファイルをコピーします。

SP_COPY_NEWER_OR_SAME

コピーされた各ファイルを調べて、バージョンリソースが同じバージョンであることを示しているか、ターゲット上の既存のコピーよりも新しくないかを判断します。

ソースファイルが新しいバージョンまたは同等のバージョンでない場合、関数は呼び出し元に、コピーを取り消すことができるユーザーに通知します。

バージョンチェック中に使用されるファイルバージョン情報は、Win32 バージョン関数によって入力されたVS_FIXEDFILEINFO構造体の dwFileVersionMS メンバーと dwFileVersionLS メンバーで指定されます。

いずれかのファイルにバージョンリソースがない場合、または同じバージョン情報がある場合、ソースファイルは新しいと見なされます。

SP_COPY_NEWER_ONLY

コピーされる各ファイルを調べて、そのバージョンリソースがターゲット上の既存のコピーよりも新しくないことを示しているかどうかを判断します。

ソースファイルが新しいが、バージョンが既存のターゲットと等しくない場合は、ファイルがコピーされます。

SP_COPY_NOOVERWRITE

ターゲットファイルが存在するかどうかを確認します。

ターゲットファイルが存在する場合、関数はコピーを取り消すことができるユーザーに通知します。

SP_COPY_NODECOMP

ファイルを圧縮解除しません。

このフラグが設定されている場合、ターゲットファイルにはソース名の圧縮されていない形式が指定されません。たとえば、f:\x86\cmd.ex_ を \install\temp にコピーすると、結果はターゲットファイル \install\temp\cmd.ex_ になります。

SP_COPY_NODECOMP フラグが指定されていない場合、ファイルは圧縮解除され、ターゲットは \install\temp\cmd.exe 呼び出されます。

DestinationName のファイル名部分を指定すると、削除され、ソースファイルのファイル名に置き換えられます。 SP_COPY_NODECOMPを指定すると、言語とバージョンの情報を確認できません。

SP_COPY_LANGUAGEAWARE

コピーされる各ファイルを調べて、言語がターゲット上にある既存のファイルの言語と異なるかどうかを判断します。

言語が異なる場合、関数はコピータスクを取り消すことができる呼び出し元に通知します。

SP_COPY_SOURCE_ABSOLUTE

SourceFile は完全なソースパスです。

INF ファイルの SourceDisksNames セクションで検索しないでください。

SP_COPY_SOURCEPATH_ABSOLUTE

SourcePathRoot は、ソースファイルの完全なパス部分です。

ファイルが配置されているソースメディアの INF ファイルの SourceDisksNames セクションで指定されている相対ソースを無視します。 SP_COPY_SOURCE_ABSOLUTEが指定されている場合、このフラグは無視されます。

SP_COPY_FORCE_IN_USE

ターゲットが存在し、使用されている場合は、次回のシステム再起動時にコピーするファイルをキューに入れます。

SP_COPY_IN_USE_NEEDS_REBOOT

ファイルがコピー操作中に使用されている場合は、システムを再起動する必要があることをユーザーに警告します。

SP_COPY_NOSKIP

ファイルをスキップするオプションをユーザーに提供しません。

SP_COPY_FORCE_NOOVERWRITE

ターゲットファイルが存在するかどうかを確認し、ターゲットが存在する場合、ファイルは上書きされず、呼び出し元には通知されません。

SP_COPY_FORCE_NEWER

コピーされる各ファイルを調べて、そのバージョンリソース (またはイメージ以外のファイルのタイムスタンプ) が、ターゲット上の既存のコピーよりも新しくないことを示していることを確認します。

コピーされるファイルが新しくない場合、ファイルはコピーされず、呼び出し元には通知されません。

SP_COPY_WARNIFSKIP

ユーザーがファイルをスキップしようとすると、ファイルをスキップするとインストールに影響する可能性があることを警告します。

システムクリティカルなファイルには、このフラグを使用します。

戻り値

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

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

解説

SetupInstallFilesFromInfSection を複数回呼び出して、複数の INF セクションで指定されたファイルをキューに入れます。キューが正常にコミットされ、ファイルがコピー、名前変更、削除された後、 SetupInstallFromInfSection を呼び出してレジストリと INI のインストール操作を実行できます。

UNC ディレクトリがファイルインストールのターゲットディレクトリとして指定されている場合は、 SetupInstallFilesFromInfSection を呼び出す前に UNC ディレクトリが存在することを確認する必要があります。セットアップ関数は、ディレクトリの存在をチェックせず、UNC ディレクトリを作成しません。ターゲット UNC ディレクトリが存在しない場合、ファイルのインストールは失敗します。

注意

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

要件

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