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 ( |