rmGetFilterList 函数 (restartmanager.h)

  • 项目

Lists RmAddFilter 函数已应用的关闭和重启操作的修改。 函数返回指向缓冲区的指针，其中包含有关已应用的修改的信息。

语法

DWORD RmGetFilterList(
  [in]            DWORD   dwSessionHandle,
  [out, optional] PBYTE   pbFilterBuf,
  [in]            DWORD   cbFilterBuf,
  [out]           LPDWORD cbFilterBufNeeded
);

参数

[in] dwSessionHandle

现有 Restart Manager 会话的句柄。

[out, optional] pbFilterBuf

指向包含修改信息的缓冲区的指针。

[in] cbFilterBuf

包含修改信息的缓冲区的大小（以字节为单位）。

[out] cbFilterBufNeeded

缓冲区中所需的字节数。

返回值

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

值 含义
ERROR_SUCCESS
0
 函数已成功完成。
ERROR_BAD_ARGUMENTS
160
 一个或多个参数无效。 如果将 NULL 指针或 0 作为需要非 null 和非零值的参数传入，则重启管理器函数将返回此错误值。
ERROR_MORE_DATA
234
 如果 pbFilterBuf 缓冲区太小而无法保存列表中的所有应用程序信息，或者如果未指定 cbFilterBufNeededed，则 RmGetFilterList 函数将返回此错误值。
ERROR_SESSION_CREDENTIAL_CONFLICT
1219
 当辅助安装程序调用此函数时，将返回此错误。 此函数仅适用于主安装程序。

注解

返回的 pbFilterBuf 缓冲区必须是 typecast 到 RM_FILTER_INFO 才能访问筛选器列表。

要求

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

另请参阅

RmAddFilter