通知 （設定 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	目標上存在較新版本的指定檔案。