Partager via

Fonction RmGetList (restartmanager.h)

  • Article

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