ShutdownBlockReasonCreate, fonction (winuser.h)
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) |