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

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

  • Статья

Списки изменения действий завершения работы и перезапуска, которые уже были применены функцией RmAddFilter. Функция возвращает указатель на буфер, содержащий сведения о примененных изменениях.

Синтаксис

DWORD RmGetFilterList(
  [in]            DWORD   dwSessionHandle,
  [out, optional] PBYTE   pbFilterBuf,
  [in]            DWORD   cbFilterBuf,
  [out]           LPDWORD cbFilterBufNeeded
);

Параметры

[in] dwSessionHandle

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

[out, optional] pbFilterBuf

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

[in] cbFilterBuf

Размер буфера, содержащего сведения об изменениях в байтах.

[out] cbFilterBufNeeded

Количество байтов, необходимое в буфере.

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

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

Значение Значение
ERROR_SUCCESS
0
 Функция успешно завершена.
ERROR_BAD_ARGUMENTS
160
 Один или несколько аргументов неверны. Это значение ошибки возвращается функцией Restart Manager, если указатель NULL или 0 передается в качестве параметра, требующего ненулевого и ненулевого значения.
ERROR_MORE_DATA
234
 Это значение ошибки возвращается функцией RmGetFilterList , если буфер pbFilterBuf слишком мал для хранения всех сведений о приложении в списке или если не указан параметр cbFilterBufNeeded .
ERROR_SESSION_CREDENTIAL_CONFLICT
1219
 Эта ошибка возвращается, когда дополнительный установщик вызывает эту функцию. Эта функция доступна только основным установщикам.

Комментарии

Возвращаемый буфер pbFilterBuf должен быть typecast для RM_FILTER_INFO для доступа к списку фильтров.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header restartmanager.h
Библиотека Rstrtmgr.lib
DLL Rstrtmgr.dll

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

RmAddFilter