SetupScanFileQueueA 関数 (setupapi.h)
[この機能は、「要件」セクションに示されているオペレーティング システムで使用できます。 今後のバージョンでは変更されるか、利用できなくなる場合もあります。 SetupAPI は、アプリケーションのインストールに使用されなくなりました。 代わりに、アプリケーション インストーラーを開発するために Windows インストーラーを使用します。 SetupAPI は、デバイス ドライバーのインストールに引き続き使用されます。]
SetupScanFileQueue 関数は、セットアップ ファイル キューをスキャンし、コピー リスト内の各ノードに対して操作を実行します。 この操作は、フラグのセットによって指定されます。 この関数は、キューがコミットされる前または後に呼び出すことができます。
構文
WINSETUPAPI BOOL SetupScanFileQueueA(
[in] HSPFILEQ FileQueue,
[in] DWORD Flags,
[in] HWND Window,
[in] PSP_FILE_CALLBACK_A CallbackRoutine,
[in] PVOID CallbackContext,
[out] PDWORD Result
);
パラメーター
[in] FileQueue
コピー リストをスキャンまたは反復処理するセットアップ ファイル キューを処理します。
[in] Flags
ファイル キュー スキャン操作を制御するために結合するフラグ。 SPQ_SCAN_FILE_PRESENCE、SPQ_SCAN_USE_CALLBACK、SPQ_SCAN_USE_CALLBACKEX、またはSPQ_SCAN_FILE_VALIDITYのいずれかを指定する必要があることに注意してください。
| フラグ | 説明 |
|---|---|
|
コピー キュー内のターゲット ファイルは、ターゲットに既に存在します。 |
|
コピー キュー内のターゲット ファイルは、有効な署名を持つターゲットに既に存在します。 Windows 2000 以降のバージョンで使用できます。 |
|
キューの各ノードのコールバック ルーチン。 コールバック ルーチンから 0 以外の値が返された場合、キュー処理は停止し、 SetupScanFileQueue は 0 を返します。 SPFILENOTIFY_QUEUESCAN通知コードを発行し、ターゲット パスへのポインターを Param1 として渡します。 |
|
キューの各ノードのコールバック ルーチン。 コールバック ルーチンから 0 以外の値が返された場合、キュー処理は停止し、 SetupScanFileQueue は 0 を返します。 SPFILENOTIFY_QUEUESCAN_EX通知を発行し、 FILEPATHS 構造体へのポインターを Param1 として渡します。 SPQ_SCAN_USE_CALLBACKEXファイルに有効な署名があることを確認します。 Windows 2000 以降で使用できます。 Windows XP でのみ、このフラグとSPQ_SCAN_FILE_PRESENCEを組み合わせて署名チェックをオフにすることができます。 |
|
キュー内のすべてのファイルが有効な署名のチェックを渡すときに指定されるフラグ。 SetupScanFileQueue は、操作でターゲットに既に存在するファイルが必要であることをユーザーに通知します。 SPQ_SCAN_FILE_PRESENCEまたはSPQ_SCAN_FILE_VALIDITYが指定されていない場合、このフラグは無視されます。 このフラグは、SPQ_SCAN_PRUNE_COPY_QUEUEやSPQ_SCAN_PRUNE_DELRENでは使用できません。 |
|
SPQ_SCAN_FILE_PRESENCEと組み合わせて、コピー キューから現在のエントリを削除します。 SPQ_SCAN_FILE_VALIDITYと組み合わせると、署名されたエントリがコピー キューから削除されます。 Windows 2000 以降で使用できます。 Windows XP でのみ、削除キューまたは名前変更キューにも指定されているファイルは、SPQ_SCAN_PRUNE_DELRENが指定されていない限り排除されません。 |
|
Windows XP 以降で使用できます。 通知SPFILENOTIFY_QUEUESCAN_SIGNERINFO発行し、 FILEPATHS_SIGNERINFO 構造体へのポインターを Param1 として渡します。 各ファイルに有効な署名がないかを確認し、コールバック関数を通じて署名情報を報告します。 |
|
SPQ_SCAN_FILE_PRESENCEまたはSPQ_SCAN_FILE_VALIDITYと組み合わせて、コピー キューにある削除キューまたは名前変更キュー内のエントリを削除します。 SPQ_SCAN_PRUNE_COPY_QUEUEと組み合わせると、コピー キューから削除されたファイルは、削除キューまたは名前変更キューにないファイルに制限されます。 Windows XP 以降で使用できます。 |
[in] Window
表示されるダイアログ ボックスを所有するためのウィンドウへの省略可能なハンドル。 Flags パラメーターにSPQ_SCAN_FILE_PRESENCEが含まれていない場合、または Flags にSPQ_SCAN_INFORM_USERが含まれていない場合、このパラメーターは使用されません。
[in] CallbackRoutine
コピー キューの各ノードで呼び出される FileCallback コールバック関数へのオプションのポインター。 コールバック関数に渡される通知コードは SPFILENOTIFY_QUEUESCAN。 Flags にSPQ_SCAN_USE_CALLBACKが含まれている場合は、このパラメーターが必要です。
[in] CallbackContext
CallbackRoutine によって指されるコールバック ルーチンに渡される呼び出し元定義データを含むコンテキストへのオプションのポインター。
[out] Result
スキャン操作の結果を受け取る変数へのポインター。
戻り値
キュー内のすべてのノードが処理された場合、関数は 0 以外の値を返します。
SPQ_SCAN_USE_CALLBACK フラグが設定されている場合、 Result の値は 0 になります。 CallbackRoutine によって指定されたコールバック ルーチンは、通知SPFILENOTIFY_QUEUESCAN送信されます。 CallbackRoutine.Param1 は、ターゲット パス情報を含む配列へのポインターを指定します。 ポインターは符号なし整数にキャストされており、コールバック ルーチンが情報にアクセスする前に、MAX_PATH要素の TCHAR 配列に再キャストする必要があります。 CallbackRoutine.Param2 は、現在のキュー ノードが使用中で、システムが再起動されるまでコピーできない場合は、SPQ_DELAYED_COPYに設定されます。 それ以外の場合、 CallbackRoutine.Param2 は値 0 を受け取ります。
SPQ_SCAN_USE_CALLBACKが設定されていない場合、Result は次の表に示すように、キューがプレゼンスまたは有効性チェックを渡したかどうかを示します。
| リターン コード | 説明 |
|---|---|
|
キューはチェックに失敗したか、チェックを渡しましたが、SPQ_SCAN_INFORM_USERが指定されており、ユーザーはファイルの新しいコピーを必要とします。 |
|
キューはチェックを渡し、SPQ_SCAN_INFORM_USERが指定されている場合、ユーザーはコピーが必要ないことを示しました。 コピー キューが空で、削除キューまたは名前変更キューに要素がないため、呼び出し元はキューのコミットをスキップできます。 |
|
キューはチェックを渡し、SPQ_SCAN_INFORM_USERが指定されている場合、ユーザーはコピーが必要ないことを示しました。 コピー キューは空ですが、削除キューまたは名前変更キューに要素があるため、呼び出し元はキューのコミットをスキップできません。 |
エラーが発生した場合、またはコールバック関数から 0 以外の値が返された場合、関数は 0 を返します。 Result が 0 以外の場合は、キュー処理を停止したコールバック関数によって返される値です。 Result が 0 の場合、GetLastError の呼び出しによって拡張エラー情報を取得できます。
注釈
注意
setupapi.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして SetupScanFileQueue を定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | setupapi.h |
| Library | Setupapi.lib |
| [DLL] | Setupapi.dll |
こちらもご覧ください
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示