共用方式為

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)

另請參閱

ShutdownBlockReasonDestroy

關閉