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


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

Удаляет все изменения действий завершения работы или перезапуска, примененные с помощью функции 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