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

Статья
03/01/2024

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

Синтаксис

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

Параметры

[in] dwSessionHandle

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

[in, optional] strModuleName

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

[in, optional] pProcess

Структура RM_UNIQUE_PROCESS для приложения. Функция RmRemoveFilter удаляет все изменения в действиях завершения работы или перезапуска указанного приложения, ранее примененных функцией RmAddFilter . Этот параметр должен иметь значение NULL , если параметр strFilename или strShortServiceName имеет значение, отличное от NULL.

[in, optional] strServiceShortName

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

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

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

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

Требования

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

Share via