CM_WaitNoPendingInstallEvents function (cfgmgr32.h)
The CMP_WaitNoPendingInstallEvents (CM_WaitNoPendingInstallEvents) function waits until there are no pending device installation activities for the PnP manager to perform.
DWORD CM_WaitNoPendingInstallEvents( [in] DWORD dwTimeout );
Specifies a time-out interval, in milliseconds.
- If dwTimeout is set to zero, the function tests whether there are pending installation events and returns immediately.
- If dwTimeout is set to INFINITE (defined in Winbase.h), the function's time-out interval never elapses.
- For all other dwTimeout values, the function returns when the specified interval elapses, even if there are still pending installation events.
The function returns one of the following values (defined in Winbase.h):
||There are no pending installation activities.|
||The time-out interval elapsed, and installation activities are still pending.|
||The function failed. Call GetLastError for additional error information.|
The function waits for an internal event object, which the PnP manager sets when it determines that no installation activities are pending.
If a non-zero time-out value is specified, then CMP_WaitNoPendingInstallEvents will return either when no installation events are pending or when the time-out period has expired, whichever comes first.
New installation events can occur at any time. This function just indicates that there are no pending installation activities at the moment it is called.
Do not call this function while processing any events inside of a system-initiated callback function that is expected to return within a short amount of time. This includes service startup (for example in the ServiceMain callback function) or while processing any control in the service handler (for example, the Handler callback function), or from installation components such as class-installers or co-installers.
For Windows XP (with no service pack installed), this function must be called from session zero, with administrator privileges. For Windows XP with Service Pack 1 (SP1) and later versions of Windows, the function can be called from any session, and administrator privileges are not required.
|Minimum supported client||Available in Windows XP and later versions of Windows.|
|Header||cfgmgr32.h (include Cfgmgr32.h)|