RM_FILTER_INFO structure (restartmanager.h)

Contains information about modifications to restart or shutdown actions. Add, remove, and list modifications to specified applications and services that have been registered with the Restart Manager session by using the RmAddFilter, RmRemoveFilter, and the RmGetFilterList functions.

Syntax

typedef struct _RM_FILTER_INFO {
  RM_FILTER_ACTION  FilterAction;
  RM_FILTER_TRIGGER FilterTrigger;
  DWORD             cbNextOffset;
  union {
    LPWSTR            strFilename;
    RM_UNIQUE_PROCESS Process;
    LPWSTR            strServiceShortName;
  };
} RM_FILTER_INFO, *PRM_FILTER_INFO;

Members

FilterAction

This member contains a RM_FILTER_ACTION enumeration value. Use the value RmNoRestart to prevent the restart of the application or service. Use the value RmNoShutdown to prevent the shutdown and restart of the application or service.

FilterTrigger

This member contains a RM_FILTER_TRIGGER enumeration value. Use the value RmFilterTriggerFile to modify the restart or shutdown actions of an application referenced by the executable's full path filename. Use the value RmFilterTriggerProcess to modify the restart or shutdown actions of an application referenced by a RM_UNIQUE_PROCESS structure. Use the value RmFilterTriggerService to modify the restart or shutdown actions of a service referenced by the short service name.

cbNextOffset

The offset in bytes to the next structure.

strFilename

If the value of FilterTrigger is RmFilterTriggerFile, this member contains a pointer to a string value that contains the application filename.

Process

If the value of FilterTrigger is RmFilterTriggerProcess, this member is a RM_PROCESS_INFO structure for the application.

strServiceShortName

If the value of FilterTrigger is RmFilterTriggerService this member is a pointer to a string value that contains the short service name.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Header restartmanager.h

See also

RM_FILTER_TRIGGER

RmGetFilterList