Поделиться через

функция CM_WaitNoPendingInstallEvents (cfgmgr32.h)

  • Статья

Функция CMP_WaitNoPendingInstallEvents (CM_WaitNoPendingInstallEvents) ожидает, пока диспетчер PnP не выполнит ожидающие действия по установке устройства.

Синтаксис

DWORD CM_WaitNoPendingInstallEvents(
  [in] DWORD dwTimeout
);

Параметры

[in] dwTimeout

Указывает интервал времени ожидания в миллисекундах.

  • Если параметр dwTimeout равен нулю, функция проверяет наличие ожидающих событий установки и немедленно возвращается.
  • Если параметр dwTimeout имеет значение INFINITE (определяется в Winbase.h), интервал времени ожидания функции никогда не истекает.
  • Для всех остальных значений dwTimeout функция возвращает по истечении указанного интервала, даже если все еще существуют ожидающие события установки.

Возвращаемое значение

Функция возвращает одно из следующих значений (определено в Winbase.h):

Код возврата Описание
WAIT_OBJECT_0
 Ожидающие действия по установке отсутствуют.
WAIT_TIMEOUT
 Истекло время ожидания, а действия по установке по-прежнему находятся в состоянии ожидания.
WAIT_FAILED
 Сбой функции. Вызовите Метод GetLastError для получения дополнительных сведений об ошибке.

Комментарии

Функция ожидает внутреннего объекта события, который задает диспетчер PnP, когда определяет, что действия установки не ожидаются.

Если указано ненулевое значение времени ожидания, то CMP_WaitNoPendingInstallEvents будет возвращать либо при отсутствии событий установки, либо по истечении времени ожидания, в зависимости от того, что произойдет раньше.

Новые события установки могут возникать в любое время. Эта функция просто указывает на отсутствие ожидающих действий установки на момент ее вызова.

Эта функция обычно используется приложениями установки устройств. Дополнительные сведения см. в разделе Написание приложения установки устройства.

Не вызывайте эту функцию при обработке событий внутри функции обратного вызова, инициированной системой, которая должна вернуться в течение короткого промежутка времени. Сюда входит запуск службы (например, в функции обратного вызова ServiceMain ) или обработка любого элемента управления в обработчике службы (например, функция обратного вызова обработчика ), а также из компонентов установки, таких как установщики классов или совместные установщики.

Для Windows XP (без установленного пакета обновления) эта функция должна вызываться из нулевого сеанса с правами администратора. Для Windows XP с пакетом обновления 1 (SP1) и более поздних версий Windows функцию можно вызывать из любого сеанса, и права администратора не требуются.

Требования

Требование Значение
Минимальная версия клиента Доступно в Windows XP и более поздних версиях Windows.
Целевая платформа Персональный компьютер
Верхняя часть cfgmgr32.h (включая Cfgmgr32.h)
Библиотека Cfgmgr32.lib
DLL Cfgmgr32.dll

См. также раздел

CM_WaitNoPendingInstallEvents

Как приложение установки устройства проверяет наличие установленных устройств