rmAddFilter 函数 (restartmanager.h)

  • 项目

修改应用于应用程序或服务的关闭或重启操作。 主安装程序可以多次调用 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
);

parameters

[in] dwSessionHandle

现有重启管理器会话的句柄。

[in, optional] strModuleName

指向以 null 结尾的字符串值的指针，该值包含应用程序可执行文件的完整路径。 对完整路径引用的应用程序应用对关闭或重启操作的修改。 如果 Application 或 strServiceShortName 参数为非 NULL，则此参数必须为 NULL。

[in, optional] pProcess

指向应用程序的 RM_UNIQUE_PROCESS 结构的指针。 对 RM_UNIQUE_PROCESS结构引用 的应用程序应用对关闭或重启操作的修改。 如果 strFilename 或 strShortServiceName 参数为非 NULL，则此参数必须为 NULL。

[in, optional] strServiceShortName

指向包含短服务名称的 以 null 结尾的字符串值的指针。 对由短服务文件名引用的服务应用对关闭或重启操作的修改。 如果 strFilename 或 Application 参数为非 NULL，则此参数必须为 NULL。

[in] FilterAction

一个RM_FILTER_ACTION枚举值，该值指定要应用的修改类型。

返回值

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

值 含义
ERROR_SUCCESS
0
 函数已成功完成。
ERROR_BAD_ARGUMENTS
160
 一个或多个参数无效。 如果将 NULL 指针或 0 作为需要非 null 和非零值的参数传入，则重启管理器函数将返回此错误值。
ERROR_SESSION_CREDENTIAL_CONFLICT
1219
 当辅助安装程序调用此函数时，将返回此错误。 此函数仅适用于主安装程序。

要求

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

请参阅

RmGetFilterList