初始化和終止回呼內容
在可以使用預設佇列回呼例程之前,在認可檔案佇列時將它指定為回呼例程,或透過從自定義回呼例程呼叫它,就必須初始化它。
SetupInitDefaultQueueCallback 函式會建置預設佇列回呼例程所使用的內容結構。 它會傳回指向該結構的 "void" 指標。 此結構對於預設回呼例程的作業而言很重要,而且必須傳遞至回呼例程。 您確實可以透過指定 void 指標為呼叫 SetupCommitFileQueue中的上下文,或者在從自定義回呼例程呼叫 SetupDefaultQueueCallback 時,將 void 指標指定為上下文參數來完成此操作。 安裝應用程式不得改變或參考此內容結構。
SetupInitDefaultQueueCallbackEx 函式也會初始化預設佇列回呼例程的內容,但它會指定第二個視窗,每次佇列傳送通知時接收呼叫端指定的進度訊息。 這可讓您使用預設磁碟提示和錯誤對話框,以及將進度列內嵌在第二個視窗中,例如,在安裝精靈的頁面。
不論您是否使用 SetupInitDefaultQueueCallback 或 SetupInitDefaultQueueCallbackEx初始化預設佇列回呼例程所使用的內容,請在佇列作業完成處理之後,呼叫 SetupTermDefaultQueueCallback,以釋放初始化內容結構中所配置的資源。