Share via

ShutdownBlockReasonCreate, fonction (winuser.h)

  • Article

Indique que le système ne peut pas être arrêté et définit une chaîne de raison à afficher à l’utilisateur si l’arrêt du système est lancé.

Syntaxe

BOOL ShutdownBlockReasonCreate(
  [in] HWND    hWnd,
  [in] LPCWSTR pwszReason
);

Paramètres

[in] hWnd

Handle de la fenêtre main de l’application.

[in] pwszReason

Raison pour laquelle l’application doit bloquer l’arrêt du système. Cette chaîne sera tronquée à des fins d’affichage après MAX_STR_BLOCKREASON caractères.

Valeur retournée

Si l’appel réussit, la valeur de retour est différente de zéro.

Si l’appel échoue, la valeur de retour est zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Cette fonction ne peut être appelée qu’à partir du thread qui a créé la fenêtre spécifiée par le paramètre hWnd . Sinon, la fonction échoue et le dernier code d’erreur est ERROR_ACCESS_DENIED.

Les applications doivent appeler cette fonction au début d’une opération qui ne peut pas être interrompue, comme la gravure d’un CD ou d’un DVD. Une fois l’opération terminée, appelez la fonction ShutdownBlockReasonDestroy pour indiquer que le système peut être arrêté.

Étant donné que les utilisateurs sont généralement pressés lors de l’arrêt du système, ils peuvent ne passer que quelques secondes à examiner les raisons d’arrêt affichées par le système. Par conséquent, il est important que vos chaînes de raison soient courtes et claires. Par exemple, « Une gravure de CD est en cours » est préférable à « Cette application bloque l’arrêt du système, car une gravure de CD est en cours. Ne pas arrêter.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau | applications UWP]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau | applications UWP]
Plateforme cible Windows
En-tête winuser.h (inclure Windows.h)
Bibliothèque User32.lib
DLL User32.dll
Ensemble d’API ext-ms-win-ntuser-misc-l1-1-0 (introduit dans Windows 8)

Voir aussi

ShutdownBlockReasonDestroy

Fermeture