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

Voir aussi

ShutdownBlockReasonDestroy

Fermeture