共用方式為

SetupDefaultQueueCallbackA 函式 （setupapi.h）

  • 發行項

[此函式可用於需求一節所指出的作業系統。 後續版本可能會變更或無法使用。 安裝程式API 不應該再用於安裝應用程式。 請改用 Windows Installer 來開發應用程式安裝程式。 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 預處理器常數的定義，將 SetupDefaultQueueCallback 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的 慣例。

要求

要求 價值
最低支援的用戶端 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 中引進）

另請參閱

函式

概觀

SetupCommitFileQueue