Condividi tramite

Funzione RmRemoveFilter (restartmanager.h)

  • Articolo

Rimuove le modifiche apportate alle azioni di arresto o riavvio applicate tramite la funzione RmAddFilter . Il programma di installazione primario può chiamare la funzione RmRemoveFilter più volte.

Sintassi

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

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 per il file eseguibile dell'applicazione. La funzione RmRemoveFilter rimuove le modifiche apportate alle azioni di arresto o riavvio dell'applicazione di riferimento applicate in precedenza dalla funzione RmAddFilter . Questo parametro deve essere NULL se il parametro Application o strServiceShortName non è NULL.

[in, optional] pProcess

Struttura RM_UNIQUE_PROCESS per l'applicazione. La funzione RmRemoveFilter rimuove le modifiche apportate alle azioni di arresto o riavvio dell'applicazione di riferimento applicate in precedenza dalla funzione RmAddFilter . 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. La funzione RmRemoveFilter rimuove le modifiche apportate alle azioni di arresto o riavvio del servizio a cui si fa riferimento in precedenza applicate dalla funzione RmAddFilter . Questo parametro deve essere NULL se il parametro strFilename o Application non è NULL.

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_FILE_NOT_FOUND
1
 Impossibile trovare il filtro specificato.
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

Requisito Valore
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