Skip to content

Latest commit

 

History

History
138 lines (114 loc) · 3.57 KB

nf-restartmanager-rmgetfilterlist.md

File metadata and controls

138 lines (114 loc) · 3.57 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:restartmanager.RmGetFilterList
RmGetFilterList function (restartmanager.h)
Lists the modifications to shutdown and restart actions that have already been applied by the RmAddFilter function.
RmGetFilterList
RmGetFilterList function [Restart Mgr]
restartmanager/RmGetFilterList
rstmgr.rmgetfilterlist
rstmgr\rmgetfilterlist.htm
rstmgr
61427838-8b23-4105-93fd-55f457fd43a7
12/05/2018
RmGetFilterList, RmGetFilterList function [Restart Mgr], restartmanager/RmGetFilterList, rstmgr.rmgetfilterlist
restartmanager.h
Windows
Windows Vista [desktop apps only]
Windows Server 2008 [desktop apps only]
Rstrtmgr.lib
Rstrtmgr.dll
Windows
19H1
RmGetFilterList
restartmanager/RmGetFilterList
c++
APIRef
kbSyntax
DllExport
Rstrtmgr.dll
RmGetFilterList

RmGetFilterList function

-description

Lists the modifications to shutdown and restart actions that have already been applied by the RmAddFilter function. The function returns a pointer to a buffer containing information about the modifications which have been applied.

-parameters

-param dwSessionHandle [in]

A handle to an existing Restart Manager session.

-param pbFilterBuf [out, optional]

A pointer to a buffer that contains modification information.

-param cbFilterBuf [in]

The size of the buffer that contains modification information in bytes.

-param cbFilterBufNeeded [out]

The number of bytes needed in the buffer.

-returns

This is the most recent error received. The function can return one of the system error codes that are defined in Winerror.h.

Value Meaning
ERROR_SUCCESS
0
The function completed successfully.
ERROR_BAD_ARGUMENTS
160
One or more arguments are not correct. This error value is returned by the Restart Manager function if a NULL pointer or 0 is passed in as a parameter that requires a non-null and non-zero value.
ERROR_MORE_DATA
234
This error value is returned by the RmGetFilterList function if the pbFilterBuf buffer is too small to hold all the application information in the list or if cbFilterBufNeeded was not specified.
ERROR_SESSION_CREDENTIAL_CONFLICT
1219
This error is returned when a secondary installer calls this function. This function is only available to primary installers.

-remarks

The returned pbFilterBuf buffer has to be typecast to RM_FILTER_INFO to access the filter list.

-see-also

RmAddFilter