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) |
另请参阅
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈