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 初始化的時(shí)候,表明系統(tǒng)不能關(guān)機(jī)并且設(shè)置一個(gè)理由用來顯示給用戶看
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.
這個(gè)函數(shù)只能被創(chuàng)建窗體的線程調(diào)用并且傳 hwnd 參數(shù),否則這個(gè)函數(shù)會(huì)失敗并且返回 ERROR_ACCESS_DENIED 錯(cuò)誤
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.
如果應(yīng)用程序開始了一個(gè)不能中斷的操作,像取CD or DVD, 此時(shí),應(yīng)用程序可以調(diào)用這個(gè)函數(shù),當(dāng)操作完成時(shí),調(diào)用
ShutDownBlockReasonDestroy() 函數(shù)指明系統(tǒng)可以關(guān)機(jī)了.
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."
因?yàn)橛脩敉ǔ<敝P(guān)掉系統(tǒng). 他們可能會(huì)花幾秒鐘看下系統(tǒng)顯示的關(guān)機(jī)理由. 所以,你的‘關(guān)機(jī)理由’需要簡(jiǎn)短明了. 像 '取CD正在處理中...' 比 '這個(gè)程序阻止了系統(tǒng)關(guān)機(jī),因?yàn)槿D正在處理中,不能關(guān)閉'要好得多.
Requirements
Minimum supported client |
Windows?Vista |
Minimum supported server |
Windows Server?2008 |
Header |
Winuser.h (include Windows.h) |
Library |
User32.lib |
DLL |
User32.dll |