DIF_FINISHINSTALL_ACTION
DIF_FINISHINSTALL_ACTION要求可讓安裝程式在所有其他裝置安裝作業完成之後，在互動式系統管理員內容中執行完成安裝動作。
傳送時
在Windows 8和更新版本中，完成安裝動作不會在裝置安裝過程中自動執行。 若要完成裝置完成安裝動作，使用者必須在控制中心按一下 [完成安裝裝置軟體]，才能完成安裝。
如需詳細資訊，請參閱 執行Finish-Install動作。
在 Windows 7 中，完成安裝程式只會在下列其中一次具有系統管理員認證的使用者內容中執行：
- 下次有系統管理員認證的使用者在附加裝置時登入。
- 重新附加裝置時。
- 當使用者選取 [掃描裝置管理員中的硬體變更時。
如果使用者在沒有系統管理許可權的情況下登入，Windows 會提示使用者同意和認證，以在系統管理員內容中執行完成安裝動作。
誰處理
類別共同安裝程式 |
可以處理 |
裝置共同安裝程式 |
可以處理 |
類別安裝程式 |
可以處理 |
安裝程式輸入
DeviceInfoSet
包含所安裝裝置之 裝置資訊集 的控制碼。
DeviceInfoData
代表所安裝裝置 之SP_DEVINFO_DATA 結構的指標。
裝置安裝參數
裝置安裝參數 (與DeviceInfoData相關聯的SP_DEVINSTALL_PARAMS結構) 。
安裝程式輸出
裝置安裝參數
如果需要重新開機系統才能完成其完成安裝動作，安裝程式會設定DI_NEEDREBOOT旗標。
安裝程式傳回值
安裝程式會傳回下表所列的其中一個值。
| 傳回值 | 意義 |
|---|---|
ERROR_DI_DO_DEFAULT |
類別安裝程式：安裝程式沒有完成安裝動作、成功完成完成安裝動作，或已判斷無法順利完成其完成安裝動作。 裝置安裝應該執行要求的預設處理。 共同安裝程式：共同安裝程式不得傳回此錯誤碼。 |
NO_ERROR |
類別安裝程式：類別安裝程式不應該傳回此錯誤碼。 如果類別安裝程式傳回此錯誤碼，則裝置安裝不會執行要求的預設處理。 共同安裝程式：安裝程式沒有完成安裝動作、成功完成完成安裝動作，或已判斷無法順利完成完成安裝動作。 |
Win32 錯誤碼 |
類別安裝程式或共同安裝程式：安裝程式在處理完成安裝動作時發生錯誤，而裝置安裝應該會在下次系統管理員的內容中列舉裝置時嘗試完成完成安裝動作。 |
預設 DIF 程式碼處理常式
Windows 7 使用 SetupDiFinishInstallAction。
Windows 8和更新版本中沒有預設的 DIF 程式碼處理常式，而且已移除 SetupDiFinishInstallAction。
註解
由於裝置安裝無法從ERROR_DI_DO_DEFAULT傳回碼或NO_ERROR傳回碼傳回碼是否實際成功，因此安裝程式應該通知使用者完成安裝程式動作的狀態。
如需完成安裝動作的詳細資訊，請參閱 裝置安裝程式如何Finish-Install動作 和 實作Finish-Install動作。
如需 DIF 程式碼的一般資訊，請參閱 處理 DIF 程式碼 和 呼叫預設 DIF 程式碼處理常式。
規格需求
版本 |
Windows Vista 到 Windows 7 支援。 |
標頭 |
Setupapi.h (包括 Setupapi.h) |