Fonction RmGetList (restartmanager.h)

Article
08/25/2023

Obtient la liste de toutes les applications et services qui utilisent actuellement des ressources qui ont été inscrites auprès de la session Restart Manager.

Syntaxe

DWORD RmGetList(
  [in]                DWORD              dwSessionHandle,
  [out]               UINT               *pnProcInfoNeeded,
  [in, out]           UINT               *pnProcInfo,
  [in, out, optional] RM_PROCESS_INFO [] rgAffectedApps,
  [out]               LPDWORD            lpdwRebootReasons
);

Paramètres

[in] dwSessionHandle

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

[out] pnProcInfoNeeded

Pointeur vers une taille de tableau nécessaire pour recevoir RM_PROCESS_INFO structures requises pour retourner des informations pour tous les services et applications affectés.

[in, out] pnProcInfo

Pointeur vers le nombre total de structures RM_PROCESS_INFO dans un tableau et le nombre de structures remplies.

[in, out, optional] rgAffectedApps

Tableau de structures RM_PROCESS_INFO qui répertorient les applications et les services à l’aide de ressources qui ont été inscrites auprès de la session.

[out] lpdwRebootReasons

Pointeur vers l’emplacement qui reçoit une valeur de l’énumération RM_REBOOT_REASON qui décrit la raison pour laquelle un redémarrage du système est nécessaire.

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_MORE_DATA 234	Cette valeur d’erreur est retournée par la fonction RmGetList si la mémoire tampon rgAffectedApps est trop petite pour contenir toutes les informations d’application dans la liste.
ERROR_CANCELLED 1223	L’opération en cours est annulée par l’utilisateur.
ERROR_SEM_TIMEOUT 121	Une fonction Restart Manager n’a pas pu obtenir un mutex d’écriture dans le registre dans le délai imparti. Un redémarrage du système est recommandé, car l’utilisation ultérieure du Gestionnaire de redémarrage risque d’échouer.
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é dans un paramètre qui nécessite une valeur non null et une valeur non nulle.
ERROR_WRITE_FAULT 29	Une opération n’a pas pu lire ou écrire dans le Registre.
ERROR_OUTOFMEMORY 14	Une opération de redémarrage du Gestionnaire n’a pas pu se terminer, car la mémoire disponible était insuffisante.
ERROR_INVALID_HANDLE 6	Il n’existe aucune session restart Manager pour le handle fourni.

Spécifications


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

RmCancelCurrentTask

Partager via