Indicates that the system cannot be shut down and sets a reason string to be displayed to the user if system shutdown is initiated.
在 shutdown 初始化的時候,表明系統不能關機并且設置一個理由用來顯示給用戶看
Syntax
BOOL WINAPI ShutdownBlockReasonCreate(
__in HWND hWnd,
__in LPCWSTR pwszReason
);
Parameters
-
hWnd [in]
-
A handle to the main window of the application.
指向主窗體的句柄
-
pwszReason [in]
-
The reason the application must block system shutdown. This string will be truncated for display purposes after MAX_STR_BLOCKREASON characters.
Return Value
If the call succeeds, the return value is nonzero.
If the call fails, the return value is zero. To get extended error information, call GetLastError.
Remarks
This function can only be called from the thread that created the window specified by the hWnd parameter. Otherwise, the function fails and the last error code is ERROR_ACCESS_DENIED.
這個函數只能被創建窗體的線程調用并且傳 hwnd 參數,否則這個函數會失敗并且返回 ERROR_ACCESS_DENIED 錯誤
Applications should call this function as they begin an operation that cannot be interrupted, such as burning a CD or DVD. When the operation has completed, call the ShutdownBlockReasonDestroy function to indicate that the system can be shut down.
如果應用程序開始了一個不能中斷的操作,像取CD or DVD, 此時,應用程序可以調用這個函數,當操作完成時,調用
ShutDownBlockReasonDestroy() 函數指明系統可以關機了.
Because users are typically in a hurry when shutting down the system, they may spend only a few seconds looking at the shutdown reasons that are displayed by the system. Therefore, it is important that your reason strings are short and clear. For example "A CD burn is in progress." is better than "This application is blocking system shutdown because a CD burn is in progress. Do not shut down."
因為用戶通常急著要關掉系統. 他們可能會花幾秒鐘看下系統顯示的關機理由. 所以,你的‘關機理由’需要簡短明了. 像 '取CD正在處理中...' 比 '這個程序阻止了系統關機,因為取CD正在處理中,不能關閉'要好得多.
Requirements
Minimum supported client |
Windows?Vista |
Minimum supported server |
Windows Server?2008 |
Header |
Winuser.h (include Windows.h) |
Library |
User32.lib |
DLL |
User32.dll |