Функция RmGetList (restartmanager.h)

Статья
11/18/2024

Возвращает список всех приложений и служб, которые в настоящее время используют ресурсы, зарегистрированные в сеансе Restart Manager.

Синтаксис

DWORD RmGetList(
  [in]                DWORD              dwSessionHandle,
  [out]               UINT               *pnProcInfoNeeded,
  [in, out]           UINT               *pnProcInfo,
  [in, out, optional] RM_PROCESS_INFO [] rgAffectedApps,
  [out]               LPDWORD            lpdwRebootReasons
);

Параметры

[in] dwSessionHandle

Дескриптор существующего сеанса Диспетчера перезапуска.

[out] pnProcInfoNeeded

Указатель на размер массива, необходимый для получения RM_PROCESS_INFO структур, необходимых для возврата сведений для всех затронутых приложений и служб.

[in, out] pnProcInfo

Указатель на общее количество RM_PROCESS_INFO структур в массиве и количестве заполненных структур.

[in, out, optional] rgAffectedApps

Массив RM_PROCESS_INFO структур, которые перечисляют приложения и службы с помощью ресурсов, зарегистрированных в сеансе.

[out] lpdwRebootReasons

Указатель на расположение, которое получает значение перечисления RM_REBOOT_REASON, описывающее причину необходимости перезагрузки системы.

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

Это самая последняя ошибка, полученная. Функция может возвращать один из кодов системных ошибок , определенных в Winerror.h.

Ценность	Значение
ERROR_SUCCESS 0	Функция успешно завершена.
ERROR_MORE_DATA 234	Это значение ошибки возвращается функцией RmGetList, если буфер rgAffectedApps слишком мал, чтобы хранить все сведения о приложении в списке.
ERROR_CANCELLED 1223	Текущая операция отменена пользователем.
ERROR_SEM_TIMEOUT 121	Функция диспетчера перезапуска не могла получить мьютекс записи реестра в течение выделенного времени. Рекомендуется перезапустить систему, так как дальнейшее использование диспетчера перезапуска, скорее всего, завершится ошибкой.
ERROR_BAD_ARGUMENTS 160	Один или несколько аргументов не верны. Это значение ошибки возвращается функцией Диспетчера перезапуска, если указатель NULL или 0 передается в параметре, требующемnull и ненулевое значение.
ERROR_WRITE_FAULT 29	Операция не смогла прочитать или записать в реестр.
ERROR_OUTOFMEMORY 14	Не удалось завершить операцию диспетчера перезапуска, так как недостаточно памяти было доступно.
ERROR_INVALID_HANDLE 6	Для предоставленного дескриптора не существует сеанса диспетчера перезапуска.
ERROR_ACCESS_DENIED 5	Путь, зарегистрированный в сеансе Restart Manager, является каталогом.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows Vista [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2008 [только классические приложения]
целевая платформа	Виндоус
заголовка	restartmanager.h
библиотеки	Rstrtmgr.lib
DLL	Rstrtmgr.dll

См. также

RmCancelCurrentTask

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