ShutdownBlockReasonCreate 函数 (winuser.h)

指示系统无法关闭，并设置在启动系统关闭时向用户显示的原因字符串。

语法

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

[in] hWnd

应用程序的main窗口的句柄。

[in] pwszReason

应用程序必须阻止系统关闭的原因。此字符串将被截断，以便在MAX_STR_BLOCKREASON个字符后显示。

如果调用成功，则返回值为非零值。

如果调用失败，则返回值为零。要获得更多的错误信息，请调用 GetLastError。

只能从创建 由 hWnd 参数指定的窗口的线程调用此函数。否则，函数将失败，并且ERROR_ACCESS_DENIED最后一个错误代码。

应用程序应在开始无法中断的操作（例如刻录 CD 或 DVD）时调用此函数。操作完成后，调用 ShutdownBlockReasonDestroy 函数以指示可以关闭系统。

由于用户在关闭系统时通常很匆忙，因此他们可能只需花费几秒钟时间查看系统显示的关闭原因。因此，原因字符串必须简短且清晰。例如，“CD 刻录正在进行”。比“此应用程序阻止系统关闭，因为正在进行 CD 刻录”要好。请勿关闭。”

要求	值
最低受支持的客户端	Windows Vista [桌面应用 \| UWP 应用]
最低受支持的服务器	Windows Server 2008 [桌面应用 \| UWP 应用]
目标平台	Windows
标头	winuser.h (包括 Windows.h)
Library	User32.lib
DLL	User32.dll
API 集	在 Windows 8) 中引入的 ext-ms-win-ntuser-misc-l1-1-0 (