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 中定义的 系统错误代码 之一。
值 | 含义 |
---|---|
|
函数已成功完成。 |
|
一个或多个参数无效。 如果将 NULL 指针或 0 作为需要非 null 和非零值的参数传入,则重启管理器函数将返回此错误值。 |
|
如果 pbFilterBuf 缓冲区太小而无法保存列表中的所有应用程序信息,或者如果未指定 cbFilterBufNeededed,则 RmGetFilterList 函数将返回此错误值。 |
|
当辅助安装程序调用此函数时,将返回此错误。 此函数仅适用于主安装程序。 |
注解
返回的 pbFilterBuf 缓冲区必须是 typecast 到 RM_FILTER_INFO 才能访问筛选器列表。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
目标平台 | Windows |
标头 | restartmanager.h |
Library | Rstrtmgr.lib |
DLL | Rstrtmgr.dll |