Partager via

Fonction RmRemoveFilter (restartmanager.h)

  • Article

Supprime toutes les modifications apportées aux actions d’arrêt ou de redémarrage qui ont été appliquées à l’aide de la fonction RmAddFilter . Le programme d’installation principal peut appeler la fonction RmRemoveFilter plusieurs fois.

Syntaxe

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

Paramètres

[in] dwSessionHandle

Handle d’une session restart Manager existante.

[in, optional] strModuleName

Pointeur vers une valeur de chaîne terminée par null qui contient le chemin d’accès complet du fichier exécutable de l’application. La fonction RmRemoveFilter supprime toutes les modifications apportées aux actions d’arrêt ou de redémarrage de l’application référencée précédemment appliquées par la fonction RmAddFilter . Ce paramètre doit avoir la valeur NULL si le paramètre Application ou strServiceShortName n’est pas NULL.

[in, optional] pProcess

Structure RM_UNIQUE_PROCESS de l’application. La fonction RmRemoveFilter supprime toutes les modifications apportées aux actions d’arrêt ou de redémarrage de l’application référencée précédemment appliquées par la fonction RmAddFilter . Ce paramètre doit avoir la valeur NULL si le paramètre strFilename ou strShortServiceName n’est pas NULL.

[in, optional] strServiceShortName

Pointeur vers une valeur de chaîne terminée par null qui contient le nom de service court. La fonction RmRemoveFilter supprime toutes les modifications apportées aux actions d’arrêt ou de redémarrage du service référencé précédemment appliquées par la fonction RmAddFilter . Ce paramètre doit avoir la valeur NULL si le paramètre strFilename ou Application n’est pas NULL.

Valeur retournée

Il s’agit de l’erreur la plus récente reçue. La fonction peut retourner l’un des codes d’erreur système définis dans Winerror.h.

Valeur Signification
ERROR_SUCCESS
0
 La fonction s’est terminée avec succès.
ERROR_FILE_NOT_FOUND
1
 Le filtre spécifié est introuvable.
ERROR_SESSION_CREDENTIAL_CONFLICT
1219
 Cette erreur est retournée lorsqu’un programme d’installation secondaire appelle cette fonction. Cette fonction n’est disponible que pour les programmes d’installation principaux.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
Plateforme cible Windows
En-tête restartmanager.h
Bibliothèque Rstrtmgr.lib
DLL Rstrtmgr.dll