Función RmRemoveFilter (restartmanager.h)

Quita las modificaciones en las acciones de apagado o reinicio que se han aplicado mediante la función RmAddFilter . El instalador principal puede llamar a la función RmRemoveFilter varias veces.

Sintaxis

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

Parámetros

[in] dwSessionHandle

Identificador de una sesión existente del Administrador de reinicio.

[in, optional] strModuleName

Puntero a un valor de cadena terminada en null que contiene la ruta de acceso completa para el archivo ejecutable de la aplicación. La función RmRemoveFilter quita las modificaciones en las acciones de apagado o reinicio de la aplicación a las que se hace referencia anteriormente aplicadas por la función RmAddFilter . Este parámetro debe ser NULL si el parámetro Application o strServiceShortName no es NULL.

[in, optional] pProcess

Estructura RM_UNIQUE_PROCESS de la aplicación. La función RmRemoveFilter quita las modificaciones en las acciones de apagado o reinicio de la aplicación a las que se hace referencia anteriormente aplicadas por la función RmAddFilter . Este parámetro debe ser NULL si el parámetro strFilename o strShortServiceName no es NULL.

[in, optional] strServiceShortName

Puntero a un valor de cadena terminada en null que contiene el nombre de servicio corto. La función RmRemoveFilter quita las modificaciones en las acciones de apagado o reinicio del servicio al que se hace referencia aplicada anteriormente por la función RmAddFilter . Este parámetro debe ser NULL si el parámetro strFilename o Application no es NULL.

Valor devuelto

Este es el error más reciente recibido. La función puede devolver uno de los códigos de error del sistema definidos en Winerror.h.

Valor Significado
ERROR_SUCCESS
0
Si se devuelve este valor, significa que la función se completó correctamente.
ERROR_FILE_NOT_FOUND
1
No se encontró el filtro especificado.
ERROR_SESSION_CREDENTIAL_CONFLICT
1219
Este error se devuelve cuando un instalador secundario llama a esta función. Esta función solo está disponible para los instaladores principales.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado restartmanager.h
Library Rstrtmgr.lib
Archivo DLL Rstrtmgr.dll