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 (

另请参阅

ShutdownBlockReasonDestroy

关闭