設定 API) (通知

通知是安裝程式函式傳送至回呼常式以指定狀態或事件的值。 Param1和Param2兩個參數會隨著通知一起傳送，並包含與通知相關的其他資訊。

回呼常式會處理通知，並將不帶正負號的整數傳回至安裝程式函式。 視安裝函式而定，您可以使用此值來指定作業或使用者選取專案，或者您可以忽略它。

安裝程式函式會使用下列語法，將通知傳送至回呼常式。

MsgHandler(          //the specified callback routine
    Context,         //context used by the callback routine
    Notification,    //notification code
    Param1,          //additional notification information
    Param2           //additional notification information
);

CoNtext參數是內容變數或結構的 void 指標，回呼常式可用來儲存後續呼叫回呼常式之間必須保存的資訊。

因為回呼常式會指定內容的實作，而且永遠不會由安裝程式函式參考或改變，所以內容不會記錄在後續通知訊息的參考資料中。

Notification參數會指定事件或狀態的不帶正負號整數值，讓安裝程式函式呼叫回呼常式。

Param1 和 Param2 是選擇性參數，可包含與通知相關的其他資訊。 這些參數是不帶正負號的整數。 如果 Param1 或 Param2 傳回不是不帶正負號整數的資訊，則會轉換成不帶正負號的整數，而且必須重新轉型為其原始資料類型，回呼常式才能使用它。

注意

下列通知代表安裝函式所使用的每個通知。 個別函式會使用這些通知的子集。 換句話說，並非每個函式都會使用每個通知。

 

安裝程式函式會使用下列通知。

通知	描述
SPFILENOTIFY_COPYERROR	檔案複製作業期間發生錯誤。
SPFILENOTIFY_DELETEERROR	檔案刪除作業期間發生錯誤。
SPFILENOTIFY_ENDCOPY	檔案複製作業已結束。
SPFILENOTIFY_ENDDELETE	檔案刪除作業已結束。
SPFILENOTIFY_ENDQUEUE	佇列已完成認可。
SPFILENOTIFY_ENDREGISTRATION	檔案的註冊或取消註冊已完成。
SPFILENOTIFY_ENDRENAME	檔案重新命名作業已結束。
SPFILENOTIFY_ENDSUBQUEUE	子佇列 (複製、重新命名或刪除) 已結束。
SPFILENOTIFY_FILEEXTRACTED	檔案已從封包擷取。
SPFILENOTIFY_FILEINCABINET	封包中遇到檔案。
SPFILENOTIFY_FILEOPDELAYED	檔案正在使用中，且目前作業已延遲到系統重新開機為止。
SPFILENOTIFY_LANGMISMATCH	目前作業的語言不符合系統語言。
SPFILENOTIFY_NEEDMEDIA	需要新的來源媒體。
SPFILENOTIFY_NEEDNEWCABINET	下一個封包中會繼續目前的檔案。
SPFILENOTIFY_QUEUESCAN	已掃描檔案佇列中的節點。
SPFILENOTIFY_QUEUESCAN_EX	已掃描檔案佇列中的節點。
SPFILENOTIFY_QUEUESCAN_SIGNERINFO	已掃描檔案佇列中的節點。
SPFILENOTIFY_RENAMEERROR	檔案重新命名作業期間發生錯誤。
SPFILENOTIFY_STARTCOPY	檔案複製作業已啟動。
SPFILENOTIFY_STARTDELETE	檔案刪除作業已啟動。
SPFILENOTIFY_STARTQUEUE	佇列已開始認可。
SPFILENOTIFY_STARTREGISTRATION	檔案的註冊或取消註冊已啟動。
SPFILENOTIFY_STARTRENAME	檔案重新命名作業已啟動。
SPFILENOTIFY_STARTSUBQUEUE	子佇列 (已啟動複製、重新命名或刪除) 。
SPFILENOTIFY_TARGETEXISTS	指定檔案的複本已存在於目標上。
SPFILENOTIFY_TARGETNEWER	目標上存在較新版本的指定檔案。