Fonction RmGetFilterList (restartmanager.h)

Article
03/01/2024

Listes les modifications apportées aux actions d’arrêt et de redémarrage qui ont déjà été appliquées par la fonction RmAddFilter. La fonction retourne un pointeur vers une mémoire tampon contenant des informations sur les modifications qui ont été appliquées.

Syntaxe

DWORD RmGetFilterList(
  [in]            DWORD   dwSessionHandle,
  [out, optional] PBYTE   pbFilterBuf,
  [in]            DWORD   cbFilterBuf,
  [out]           LPDWORD cbFilterBufNeeded
);

Paramètres

[in] dwSessionHandle

Handle d’une session restart Manager existante.

[out, optional] pbFilterBuf

Pointeur vers une mémoire tampon qui contient des informations de modification.

[in] cbFilterBuf

Taille de la mémoire tampon qui contient des informations de modification en octets.

[out] cbFilterBufNeeded

Nombre d’octets nécessaires dans la mémoire tampon.

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_BAD_ARGUMENTS 160	Un ou plusieurs arguments sont incorrects. Cette valeur d’erreur est retournée par la fonction Restart Manager si un pointeur NULL ou 0 est passé en tant que paramètre qui nécessite une valeur non null et une valeur non nulle.
ERROR_MORE_DATA 234	Cette valeur d’erreur est retournée par la fonction RmGetFilterList si la mémoire tampon pbFilterBuf est trop petite pour contenir toutes les informations d’application dans la liste ou si cbFilterBufNeededed n’a pas été spécifié.
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.

Remarques

La mémoire tampon pbFilterBuf retournée doit être typecast pour RM_FILTER_INFO accéder à la liste des filtres.

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

Voir aussi

RmAddFilter

Partager via