CM_WaitNoPendingInstallEvents 函数 (cfgmgr32.h)

CMP_WaitNoPendingInstallEvents (CM_WaitNoPendingInstallEvents) 函数将等待，直到没有挂起的设备安装活动可供 PnP 管理器执行。

语法

DWORD CM_WaitNoPendingInstallEvents(
  [in] DWORD dwTimeout
);

[in] dwTimeout

指定超时间隔（以毫秒为单位）。

函数返回 winbase.h) 中定义的以下值 (之一：

返回代码	说明
WAIT_OBJECT_0	没有挂起的安装活动。
WAIT_TIMEOUT	超时间隔已过，安装活动仍处于挂起状态。
WAIT_FAILED	函数失败。调用 GetLastError 以获取其他错误信息。

函数等待内部事件对象，PnP 管理器在确定没有挂起的安装活动时设置该事件对象。

如果指定了非零超时值，则 CMP_WaitNoPendingInstallEvents 在没有挂起的安装事件或超时期限已过期（以先到者为准）时返回。

可以随时发生新的安装事件。此函数仅指示调用它时没有挂起的安装活动。

此函数通常由设备安装应用程序使用。有关详细信息，请参阅编写设备安装应用程序。

在处理系统启动的回调函数内预计在短时间内返回的任何事件时，请勿调用此函数。这包括服务启动 (例如，在 ServiceMain 回调函数) 或处理服务处理程序 (（例如， 处理程序 回调函数) ）中的任何控件时，或者从类安装程序或共同安装程序等安装组件中处理任何控件。

对于未) 安装 Service Pack 的 Windows XP (，必须使用管理员权限从会话 0 调用此函数。对于具有 Service Pack 1 的 Windows XP (SP1) 及更高版本的 Windows，可以从任何会话调用函数，并且不需要管理员权限。

要求	值
最低受支持的客户端	在 Windows XP 和更高版本的 Windows 中可用。
目标平台	桌面
标头	cfgmgr32.h (包括 Cfgmgr32.h)
Library	Cfgmgr32.lib
DLL	Cfgmgr32.dll