实施 Finish-Install 操作

注意

通用或移动驱动程序包不支持本部分所述的功能。 请参阅 使用通用 INF 文件。

安装程序 (类安装程序、类辅助安装程序或设备辅助安装程序) 提供完成安装操作。 完成安装操作可以运行可执行程序、创建进程、创建线程或在设备驱动程序安装完成安装过程中执行代码。

若要实现完成安装操作，安装程序：

1. 当安装程序处理DIF_NEWDEVICEWIZARD_FINISHINSTALL DIF 代码并返回以下错误代码之一时，设置 DI_FLAGSEX_FINISHINSTALL_ACTION 标志：

   • 如果它是没有完成安装向导页的类安装程序，则ERROR_DI_DO_DEFAULT。
   • NO_ERROR是否是具有完成安装向导页的类安装程序，或者具有或不带完成安装向导页的辅助安装程序。

2. 处理 DIF_FINISHINSTALL_ACTION 请求时执行完成安装操作。

   安装程序返回下表中的错误代码之一。

   错误代码	含义
   ERROR_DI_DO_DEFAULT	类安装程序：类安装程序已成功运行其完成安装操作，并请求 Windows 执行其默认处理。 如果类安装程序没有完成安装操作，则还应返回此错误代码。 设备或类共同安装程序：共同安装程序不返回此错误代码。
   NO_ERROR	类安装程序：类安装程序已成功运行其完成安装操作。 Windows 不应执行其默认处理。 设备或类共同安装程序：辅助安装程序已成功运行其完成安装操作，或者没有完成安装操作。
   Microsoft Win32 错误	安装程序遇到错误，但应再次尝试完成安装操作。 返回 Win32 错误代码指示 Windows 应在下次枚举设备时运行另一个完成安装过程以完成安装操作。

注意 如果完成安装操作失败且不应再次尝试，类安装程序将返回ERROR_DI_DO_DEFAULT，设备或类辅助安装程序返回NO_ERROR。

有关如何开发完成安装操作的信息，请参阅 实现Finish-Install操作指南 。对于演示如何实现完成-安装操作的示例代码，请参阅以下主题：

代码示例：类安装程序中的 Finish-Install 操作

代码示例：辅助安装程序中的 Finish-Install 操作