Fonction RmAddFilter (restartmanager.h)

Modifie les actions d’arrêt ou de redémarrage appliquées à une application ou à un service. Le programme d’installation principal peut appeler la fonction RmAddFilter plusieurs fois. L’appel le plus récent remplace toutes les modifications précédentes apportées au même fichier, processus ou service.

Syntaxe

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

Paramètres

[in] dwSessionHandle

Handle pour une session du Gestionnaire de redémarrage existante.

[in, optional] strModuleName

Pointeur vers une valeur de chaîne terminée par null qui contient le chemin d’accès complet au fichier exécutable de l’application. Les modifications apportées aux actions d’arrêt ou de redémarrage sont appliquées à l’application référencée par le chemin d’accès complet. Ce paramètre doit être NULL si le paramètre Application ou strServiceShortName n’est pas NULL.

[in, optional] pProcess

Pointeur vers une structure RM_UNIQUE_PROCESS pour l’application. Les modifications apportées aux actions d’arrêt ou de redémarrage sont appliquées à l’application référencée par la structure RM_UNIQUE_PROCESS . Ce paramètre doit être 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. Les modifications apportées aux actions d’arrêt ou de redémarrage sont appliquées au service référencé par un nom de fichier de service court. Ce paramètre doit avoir la valeur NULL si le paramètre strFilename ou Application n’est pas NULL.

[in] FilterAction

Valeur d’énumération RM_FILTER_ACTION qui spécifie le type de modification à appliquer.

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.

Spécifications

Voir aussi

RmGetFilterList