Méthode Win32ShutdownTracker de la classe Win32_OperatingSystem

Article
06/12/2023

La méthode Win32ShutdownTracker fournit le même ensemble d’options d’arrêt prises en charge par la méthode Win32Shutdown dans Win32_OperatingSystem, mais elle vous permet également de spécifier des commentaires, une raison d’arrêt ou un délai d’expiration.

Syntaxe

uint32 Win32ShutdownTracker(
  [in] uint32 Timeout,
  [in] string Comment,
  [in] uint32 ReasonCode,
  [in] sint32 Flags
);

Paramètres

Délai d’expiration [in]: Temps, en secondes, avant l’arrêt. La valeur par défaut est 0 (zéro).
Commentaire [in]: Message à afficher dans la boîte de dialogue d’arrêt qui est également stocké en tant que commentaire dans l’entrée du journal des événements.
ReasonCode [in]: Raison du lancement de l’arrêt.
Indicateurs [in]: Jeu d’indicateurs bitmap pour arrêter l’ordinateur. Pour forcer une commande, ajoutez l’indicateur Force (4) à la valeur de commande. L’utilisation de Force conjointement avec l’arrêt ou le redémarrage sur un ordinateur distant arrête immédiatement tout (y compris WMI, COM, etc.) ou redémarre l’ordinateur distant. Il en résulte une valeur de retour indéterminée.
0 (0x0): Déconnexion
4 (0x4): Déconnexion forcée (0 + 4)
1 (0x1): Shutdown
5 (0x5): Arrêt forcé (1 + 4)
2 (0x2): Reboot
6 (0x6): Redémarrage forcé (2 + 4)
8 (0x8): Mise hors tension
12 (0xC): Mise hors tension forcée (8 + 4)

Valeur retournée

Retourne zéro (0) pour indiquer la réussite. Tout autre nombre indique une erreur. Pour obtenir des codes d’erreur, consultez Constantes d’erreur WMI ou WbemErrorEnum. Pour connaître les valeurs HRESULT générales, consultez Codes d’erreur système.

Réussite (0)
Autres (1 à 4294967295)

Notes

Le processus appelant doit avoir le privilège SE_SHUTDOWN_NAME .

Exemples

L’exemple de code VBScript suivant décrit comment appeler Win32ShutdownTracker.

Set objArgs = Wscript.Arguments 

intTimeOut = objArgs(0) 'Countdown time (in seconds) before action
strComment = objArgs(1) 'Message to display
intFlags = objArgs(2) 'Set of flags to shutdown the computer:
'0 = Logoff, 4 = Forced Logoff (0+4), 1 = Shutdown, 2 = Reboot, 6 = Forced Reboot (2+4), 8 = Power Off, 12 = Forced Power Off (8+4) - 2 (Reboot) 

strComputer = "." 

Set objWMIService = GetObject("winmgmts:{impersonationLevel=impersonate,(Shutdown)}!\\" & strComputer & "\root\cimv2")

Set colOperatingSystems = objWMIService.ExecQuery ("Select * from Win32_OperatingSystem") 

For Each objOperatingSystem in colOperatingSystems 
objOperatingSystem.Win32ShutdownTracker intTimeOut,strComment,0,intFlags 
Next

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
Espace de noms	Racine\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

Voir aussi

Classes du système d’exploitation
Win32_OperatingSystem
Win32Shutdown

Partager via