SetupInitDefaultQueueCallbackEx 函式 (setupapi.h)
[此函式可用於需求一節中所述的作業系統。 它在後續版本中可能會變更或無法使用。 安裝程式API 不應再用於安裝應用程式。 請改用 Windows Installer 來開發應用程式安裝程式。 SetupAPI 會繼續用於安裝設備磁碟機。]
SetupInitDefaultQueueCallbackEx函式會以與 SetupInitDefaultQueueCallback相同的方式，初始化安裝程式 API 隨附的預設佇列回呼常式所使用的內容，但會提供額外的視窗給回呼函式以接受進度訊息。
語法
WINSETUPAPI PVOID SetupInitDefaultQueueCallbackEx(
[in] HWND OwnerWindow,
[in] HWND AlternateProgressWindow,
[in] UINT ProgressMessage,
[in] DWORD Reserved1,
[in] PVOID Reserved2
);
參數
[in] OwnerWindow
要當做預設回呼常式所產生之任何對話方塊父代的視窗控制碼。
[in] AlternateProgressWindow
處理接收進度訊息的視窗。 若要防止顯示進度訊息，您可以指定要INVALID_HANDLE_VALUE此參數。
[in] ProgressMessage
當複製佇列啟動時，以及每次複製檔案時傳送至 AlternateProgressWindow 的訊息。
[in] Reserved1
預設回呼常式傳送至 AlternateProgressWindow 的第一個訊息參數。
[in] Reserved2
預設回呼常式傳送至 AlternateProgressWindow 的第二個訊息參數。
傳回值
SetupInitDefaultQueueCallbackEx 會傳回預設佇列回呼常式所使用內容的指標。 只有在記憶體不足時，此函式才能失敗。 如果此函式失敗，它會傳回 Null ，而且不會設定執行緒的最後一個錯誤碼。
備註
當佇列開始認可複製子佇列時，預設佇列回呼常式會將訊息傳送至 AlternateProgressWindow中指定的視窗。 Reserved1 具有值 0， 而 Reserved2 包含排入佇列檔案複製作業數目的指標。
針對每個已完成的檔案複製作業，預設佇列回呼常式會將訊息傳送至 AlternateProgressWindow，可用來「刻度」進度列。 Reserved1 的值為 1， 而 Reserved2 為零。
SetupInitDefaultQueueCallbackEx 可用來取得磁片提示、錯誤處理等的預設行為，也提供內嵌在精靈頁面或其他特製化對話方塊中的量測計。
不論您是否使用 SetupInitDefaultQueueCallback 或 SetupInitDefaultQueueCallbackEx初始化預設佇列回呼常式所使用的內容，在佇列作業完成處理之後，呼叫 SetupTermDefaultQueueCallback 以釋放初始化內容結構時配置的資源。 如需詳細資訊，請參閱 初始化和終止回呼內容。
規格需求
| 最低支援的用戶端 | 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 版) |