RmGetList, fonction (restartmanager.h)

Article
11/18/2024

Obtient la liste de toutes les applications et services qui utilisent actuellement des ressources 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 d’une session Restart Manager existante.

[out] pnProcInfoNeeded

Pointeur vers une taille de tableau nécessaire pour recevoir RM_PROCESS_INFO structures requises pour retourner des informations pour toutes les applications et services 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 services à l’aide de ressources 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 de retour

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 correctement.
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 actuelle est annulée par l’utilisateur.
ERROR_SEM_TIMEOUT 121	Une fonction Restart Manager n’a pas pu obtenir un mutex d’écriture de Registre dans le temps imparti. Un redémarrage du système est recommandé, car une utilisation supplémentaire du Gestionnaire de redémarrage est susceptible d’échouer.
ERROR_BAD_ARGUMENTS 160	Un ou plusieurs arguments ne sont pas corrects. Cette valeur d’erreur est retournée par la fonction Restart Manager si un pointeur NULL ou 0 est transmis dans un paramètre qui nécessite une valeur null nonnull et 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 restart Manager n’a pas pu se terminer, car la mémoire n’a pas été suffisante.
ERROR_INVALID_HANDLE 6	Aucune session Restart Manager n’existe pour le handle fourni.
ERROR_ACCESS_DENIED 5	Un chemin d’accès inscrit à la session Restart Manager est un répertoire.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows Vista [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2008 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	restartmanager.h
bibliothèque	Rstrtmgr.lib
DLL	Rstrtmgr.dll

Voir aussi

RmCancelCurrentTask

Partager via