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 版)

請參閱

函式

概觀

SetupInitDefaultQueueCallback