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 函数应用。 如果 Application 或 strServiceShortName 参数为非 NULL，则此参数必须为 NULL。

[in, optional] pProcess

应用程序的 RM_UNIQUE_PROCESS 结构。 RmRemoveFilter 函数删除对引用的应用程序关闭或重启操作所做的任何修改，这些操作以前由 RmAddFilter 函数应用。 如果 strFilename 或 strShortServiceName 参数为非 NULL，则此参数必须为 NULL。

[in, optional] strServiceShortName

指向包含短服务名称的 以 null 结尾的字符串值的指针。 RmRemoveFilter 函数删除对 RmAddFilter 函数以前应用的被引用服务的关闭或重启操作所做的任何修改。 如果 strFilename 或 Application 参数为非 NULL，则此参数必须为 NULL。

返回值

这是收到的最新错误。 函数可以返回 Winerror.h 中定义的 系统错误代码 之一。

值 含义
ERROR_SUCCESS
0
 函数已成功完成。
ERROR_FILE_NOT_FOUND
1
 找不到指定的筛选器。
ERROR_SESSION_CREDENTIAL_CONFLICT
1219
 当辅助安装程序调用此函数时，将返回此错误。 此函数仅适用于主安装程序。

要求

要求 值
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 restartmanager.h
Library Rstrtmgr.lib
DLL Rstrtmgr.dll