Funzione RmAddFilter (restartmanager.h)

Articolo
08/25/2023

Modifica le azioni di arresto o riavvio applicate a un'applicazione o a un servizio. Il programma di installazione primario può chiamare la funzione RmAddFilter più volte. La chiamata più recente esegue l'override di tutte le modifiche precedenti allo stesso file, processo o servizio.

Sintassi

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

Parametri

[in] dwSessionHandle

Handle per una sessione di Gestione riavvio esistente.

[in, optional] strModuleName

Puntatore a un valore stringa con terminazione null contenente il percorso completo del file eseguibile dell'applicazione. Le modifiche apportate alle azioni di arresto o riavvio vengono applicate per l'applicazione a cui fa riferimento il percorso completo. Questo parametro deve essere NULL se il parametro Application o strServiceShortName non è NULL.

[in, optional] pProcess

Puntatore a una struttura di RM_UNIQUE_PROCESS per l'applicazione. Le modifiche apportate alle azioni di arresto o riavvio vengono applicate per l'applicazione a cui fa riferimento la struttura RM_UNIQUE_PROCESS . Questo parametro deve essere NULL se il parametro strFilename o strShortServiceName è diverso da NULL.

[in, optional] strServiceShortName

Puntatore a un valore stringa con terminazione null contenente il nome del servizio breve. Le modifiche apportate alle azioni di arresto o riavvio vengono applicate per il servizio a cui fa riferimento il nome del file di servizio breve. Questo parametro deve essere NULL se il parametro strFilename o Application non è NULL.

[in] FilterAction

Valore di enumerazione RM_FILTER_ACTION che specifica il tipo di modifica da applicare.

Valore restituito

Si tratta dell'errore più recente ricevuto. La funzione può restituire uno dei codici di errore di sistema definiti in Winerror.h.

Valore	Significato
ERROR_SUCCESS 0	La funzione è stata completata correttamente.
ERROR_BAD_ARGUMENTS 160	Uno o più argomenti non sono corretti. Questo valore di errore viene restituito dalla funzione Restart Manager se un puntatore NULL o 0 viene passato come parametro che richiede un valore diverso da null e non zero.
ERROR_SESSION_CREDENTIAL_CONFLICT 1219	Questo errore viene restituito quando un programma di installazione secondario chiama questa funzione. Questa funzione è disponibile solo per i programmi di installazione primari.

Requisiti


Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	restartmanager.h
Libreria	Rstrtmgr.lib
DLL	Rstrtmgr.dll

Vedi anche

RmGetFilterList

Condividi tramite