Función RmAddFilter (restartmanager.h)
Modifica las acciones de apagado o reinicio que se aplican a una aplicación o servicio. El instalador principal puede llamar a la función RmAddFilter varias veces. La llamada más reciente invalida las modificaciones anteriores en el mismo archivo, proceso o servicio.
Sintaxis
DWORD RmAddFilter(
[in] DWORD dwSessionHandle,
[in, optional] LPCWSTR strModuleName,
[in, optional] RM_UNIQUE_PROCESS *pProcess,
[in, optional] LPCWSTR strServiceShortName,
[in] RM_FILTER_ACTION FilterAction
);
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 al archivo ejecutable de la aplicación. Las modificaciones en las acciones de apagado o reinicio se aplican a la aplicación a la que hace referencia la ruta de acceso completa. Este parámetro debe ser NULL si el parámetro Application o strServiceShortName no es NULL.
[in, optional] pProcess
Puntero a una estructura de RM_UNIQUE_PROCESS para la aplicación. Las modificaciones en las acciones de apagado o reinicio se aplican a la aplicación a la que hace referencia la estructura RM_UNIQUE_PROCESS . 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. Las modificaciones en las acciones de apagado o reinicio se aplican al servicio al que hace referencia el nombre de archivo de servicio corto. Este parámetro debe ser NULL si el parámetro strFilename o Application no es NULL.
[in] FilterAction
Valor de enumeración RM_FILTER_ACTION que especifica el tipo de modificación que se va a aplicar.
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 |
|---|---|
|
Si se devuelve este valor, significa que la función se completó correctamente. |
|
Uno o más argumentos son incorrectos. La función Restart Manager devuelve este valor de error si se pasa un puntero NULL o 0 como parámetro que requiere un valor distinto de NULL y distinto de cero. |
|
Este error se devuelve cuando un instalador secundario llama a esta función. Esta función solo está disponible para los instaladores principales. |
Requisitos
| 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 |