ShutdownBlockReasonCreate 函式 (winuser.h)
指出系統無法關機,並在系統關閉時設定要向用戶顯示的原因字串。
語法
BOOL ShutdownBlockReasonCreate(
[in] HWND hWnd,
[in] LPCWSTR pwszReason
);
參數
[in] hWnd
應用程式的主視窗句柄。
[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) |
程式庫 | User32.lib |
Dll | User32.dll |
API 集合 | ext-ms-win-ntuser-misc-l1-1-0 (於 Windows 8) |