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

Статья
08/25/2023

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

Синтаксис

DWORD RmAddFilter(
  [in]           DWORD             dwSessionHandle,
  [in, optional] LPCWSTR           strModuleName,
  [in, optional] RM_UNIQUE_PROCESS *pProcess,
  [in, optional] LPCWSTR           strServiceShortName,
  [in]           RM_FILTER_ACTION  FilterAction
);

Параметры

[in] dwSessionHandle

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

[in, optional] strModuleName

Указатель на строковое значение, завершающееся null, которое содержит полный путь к исполняемому файлу приложения. Изменения в действиях завершения работы или перезапуска применяются к приложению, на которое ссылается полный путь. Этот параметр должен иметь значение NULL , если параметр Application или strServiceShortName не равен NULL.

[in, optional] pProcess

Указатель на структуру RM_UNIQUE_PROCESS для приложения. Изменения действий завершения работы или перезапуска применяются к приложению, на которое ссылается структура RM_UNIQUE_PROCESS . Этот параметр должен иметь значение NULL , если параметр strFilename или strShortServiceName не равен NULL.

[in, optional] strServiceShortName

Указатель на строковое значение, завершающееся null, которое содержит короткое имя службы. Изменения действий завершения работы или перезапуска применяются к службе, на которую ссылается короткое имя файла службы. Этот параметр должен иметь значение NULL , если параметр strFilename или Application не равен NULL.

[in] FilterAction

Значение перечисления RM_FILTER_ACTION , указывающее тип применяемого изменения.

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

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

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

Требования


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

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

RmGetFilterList

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