共用方式為


SPFILENOTIFY_NEEDNEWCABINET訊息

SPFILENOTIFY_NEEDNEWCABINET通知是由SetupIterateCabinet傳送,以指出目前的檔案會繼續在另一個封包中。 然後,您的回呼常式可以呼叫 SetupPromptForDisk,或建立自己的對話方塊來提示使用者插入下一個磁片。

SPFILENOTIFY_NEEDNEWCABINET
  Param1 = (UINT) CabinetInfo;
  Param2 = (UINT) NewPath;
            

參數

Param1

CABINET_INFO結構的指標,其中包含要擷取之封包和檔案的相關資訊。

Param2

如果回呼傳回NO_ERROR,這個參數是 Null 終止字串的指標。 如果字串不是空的,它會指定封包的新路徑。

傳回值

您的常式應該會傳回下列其中一個值。

傳回碼 Description
NO_ERROR
未發生任何錯誤,請繼續處理封包。
ERROR_XXX
發生指定型別的錯誤。 SetupIterateCabinet函式會傳回FALSE,而指定的錯誤碼將會由GetLastError呼叫傳回。

注意

沒有預設封包回呼常式;因此,您必須提供回呼常式來處理 SetupIterateCabinet所傳送的通知。

備註

如果回呼常式傳回NO_ERROR, SetupIterateCabinet 會檢查 Param2所指向的緩衝區。 如果緩衝區不是空的,則會包含新的來源路徑。 如果緩衝區是空的,則會假設來源路徑保持不變。

如果需要插入新的媒體,您的回呼函式應該先確保封包可以存取,再傳回 ,呼叫 SetupPromptForDisk 函式。

規格需求

需求
最低支援的用戶端
Windows XP [僅限傳統型應用程式]
最低支援的伺服器
Windows Server 2003 [僅限傳統型應用程式]
標頭
Setupapi.h

另請參閱

概觀

通知

CABINET_INFO

SetupIterateCabinet