Поделиться через


Функция ShutdownBlockReasonCreate (winuser.h)

Указывает, что система не может быть завершена, и задает строку причины, отображаемую для пользователя, если запущено завершение работы системы.

Синтаксис

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

Параметры

[in] hWnd

Дескриптор main окна приложения.

[in] pwszReason

Причина, по которой приложение должно блокировать завершение работы системы. Эта строка будет усечена для отображения после MAX_STR_BLOCKREASON символов.

Возвращаемое значение

Если вызов выполнен успешно, возвращаемое значение не равно нулю.

Если вызов завершается ошибкой, возвращаемое значение равно нулю. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Комментарии

Эту функцию можно вызвать только из потока, создавшего окно, указанное параметром hWnd . В противном случае функция завершается сбоем, и код последней ошибки ERROR_ACCESS_DENIED.

Приложения должны вызывать эту функцию, когда они начинают операцию, которая не может быть прервана, например запись компакт-диска или DVD-диска. После завершения операции вызовите функцию ShutdownBlockReasonDe shutdown , чтобы указать, что система может быть завершена.

Так как пользователи обычно спешат при завершении работы системы, они могут потратить всего несколько секунд на просмотр причин завершения работы, отображаемых системой. Поэтому важно, чтобы строки причины были короткими и ясными. Например, "Выполняется запись компакт-диска" лучше, чем "Это приложение блокирует завершение работы системы, так как выполняется запись компакт-диска. Не завершайте работу".

Требования

Требование Значение
Минимальная версия клиента Windows Vista [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2008 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header winuser.h (включая Windows.h)
Библиотека User32.lib
DLL User32.dll
Набор API ext-ms-win-ntuser-misc-l1-1-0 (представлено в Windows 8)

См. также раздел

ShutdownBlockReasonDe shutdown

Завершает работу