RmRemoveFilter function (restartmanager.h)

Removes any modifications to shutdown or restart actions that have been applied using the RmAddFilter function. The primary installer can call the RmRemoveFilter function multiple times.

Syntax

DWORD RmRemoveFilter(
  [in]           DWORD             dwSessionHandle,
  [in, optional] LPCWSTR           strModuleName,
  [in, optional] RM_UNIQUE_PROCESS *pProcess,
  [in, optional] LPCWSTR           strServiceShortName
);

Parameters

[in] dwSessionHandle

A handle to an existing Restart Manager session.

[in, optional] strModuleName

A pointer to a null-terminated string value that contains the full path for the application's executable file. The RmRemoveFilter function removes any modifications to the referenced application's shutdown or restart actions previously applied by the RmAddFilter function. This parameter must be NULL if the Application or strServiceShortName parameter is non-NULL.

[in, optional] pProcess

The RM_UNIQUE_PROCESS structure for the application. The RmRemoveFilter function removes any modifications to the referenced application's shutdown or restart actions previously applied by the RmAddFilter function. This parameter must be NULL if the strFilename or strShortServiceName parameter is non-NULL.

[in, optional] strServiceShortName

A pointer to a null-terminated string value that contains the short service name. The RmRemoveFilter function removes any modifications to the referenced service's shutdown or restart actions previously applied by the RmAddFilter function. This parameter must be NULL if the strFilename or Application parameter is non-NULL.

Return value

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

Requirements