次の方法で共有

SetupDefaultQueueCallbackA 関数 (setupapi.h)

  • [アーティクル]

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

SetupDefaultQueueCallback 関数は、セットアップ API に含まれる既定のキュー コールバック ルーチンです。 これを使用して、SetupCommitFileQueue 関数によって送信された通知を処理できます。

構文

WINSETUPAPI UINT SetupDefaultQueueCallbackA(
  [in] PVOID    Context,
  [in] UINT     Notification,
  [in] UINT_PTR Param1,
  [in] UINT_PTR Param2
);

パラメーター

[in] Context

SetupInitDefaultQueueCallback または SetupInitDefaultQueueCallbackEx 関数 によって初期化されたコンテキストへのポインター。

[in] Notification

キュー アクションの通知。 このパラメーターには、次の表に示す値のいずれかを指定できます。

価値 意味
SPFILENOTIFY_STARTQUEUE
 キューに登録されたファイル操作を開始しました。
SPFILENOTIFY_ENDQUEUE
 キューに登録されたファイル操作が完了しました。
SPFILENOTIFY_STARTSUBQUEUE
 サブキューのコピー、名前変更、または削除を開始しました。
SPFILENOTIFY_ENDSUBQUEUE
 サブキューのコピー、名前の変更、または削除を完了しました。
SPFILENOTIFY_STARTRENAME
 名前変更操作を開始しました。
SPFILENOTIFY_ENDRENAME
 名前の変更操作が完了しました。
SPFILENOTIFY_RENAMEERROR
 ファイルの名前変更中にエラーが発生しました。
SPFILENOTIFY_STARTDELETE
 削除操作を開始しました。
SPFILENOTIFY_ENDDELETE
 削除操作を完了しました。
SPFILENOTIFY_DELETEERROR
 ファイルの削除中にエラーが発生しました。
SPFILENOTIFY_STARTCOPY
 コピー操作を開始しました。
SPFILENOTIFY_ENDCOPY
 コピー操作を完了しました。
SPFILENOTIFY_COPYERROR
 ファイルのコピー中にエラーが発生しました。
SPFILENOTIFY_NEEDMEDIA
 新しいメディアが必要です。
SPFILENOTIFY_LANGMISMATCH
 既存のターゲット ファイルの言語は、ソースとは異なります。
SPFILENOTIFY_TARGETEXISTS
 ターゲット ファイルが存在します。
SPFILENOTIFY_TARGETNEWER
既存のターゲット ファイルがソースより新しい。

[in] Param1

追加のメッセージ情報。 このパラメーターの内容は、Notification パラメーターの値によって異なります。

[in] Param2

追加のメッセージ情報。 このパラメーターの内容は、Notification パラメーターの値によって異なります。

戻り値

次の表に示す値のいずれかである SetupCommitFileQueue を する符号なし整数を返します。

リターン コード 形容
FILEOP_ABORT
 操作を中止します。
FILEOP_DOIT
 ファイル操作を実行します。
FILEOP_SKIP
 操作をスキップします。
FILEOP_RETRY
 操作を再試行します。
FILEOP_NEWPATH
 操作の新しいパスを取得します。
 

拡張エラー情報を取得するには、GetLastError呼び出します。

備考

SetupDefaultQueueCallback 関数は、通常、カスタム キュー コールバック ルーチンによってのみ明示的に呼び出されます。 カスタム コールバックは、キューコミット通知のサブセットを処理し、SetupDefaultQueueCallback 関数を呼び出して、残りの通知を処理します。

詳細については、「キュー通知を する」を参照してください。

手記

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

必要条件

要件 価値
サポートされる最小クライアント Windows XP [デスクトップ アプリのみ]
サポートされる最小サーバー Windows Server 2003 [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー setupapi.h
ライブラリ Setupapi.lib
DLL Setupapi.dll
API セットの ext-ms-win-setupapi-classinstallers-l1-1-2 (Windows 10 バージョン 10.0.14393 で導入)

関連項目

Functions

の概要

SetupCommitFileQueue の