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 ，可以是下表所示的其中一個值。

傳回碼 Description
FILEOP_ABORT
 中止作業。
FILEOP_DOIT
 執行檔案作業。
FILEOP_SKIP
 略過作業。
FILEOP_RETRY
 重試作業。
FILEOP_NEWPATH
 取得作業的新路徑。
 

若要取得擴充的錯誤資訊，請呼叫 GetLastError。

備註

SetupDefaultQueueCallback 函式通常只能由自定義佇列回呼例程明確呼叫。 自定義回呼會處理佇列認可通知的子集，並呼叫 SetupDefaultQueueCallback 函式來處理其餘的通知。

如需詳細資訊，請參閱 佇列通知。

注意

setupapi.h 標頭會將 SetupDefaultQueueCallback 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。

規格需求

需求 值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 setupapi.h
程式庫 Setupapi.lib
Dll Setupapi.dll
API 集合 ext-ms-win-setupapi-classinstallers-l1-1-2 (Windows 10 10.0.14393 版)

請參閱

函式

概觀

SetupCommitFileQueue