Share via

系統關機原因代碼

  • 發行項

exitWindowsEx和InitiateSystemShutdownEx函式會在dwReason參數中使用關機原因代碼。

系統將處理最多MAX_NUM_REASONS原因碼。 MAX_NUM_REASONS是以 reason.h 定義。

以下是主要原因旗標。 它們表示一般問題類型。

常數/值 Description
SHTDN_REASON_MAJOR_APPLICATION
0x00040000
 應用程式問題。
SHTDN_REASON_MAJOR_HARDWARE
0x00010000
 硬體問題。
SHTDN_REASON_MAJOR_LEGACY_API
0x00070000
 已使用 InitiateSystemShutdown 函式，而不是 InitiateSystemShutdownEx。
SHTDN_REASON_MAJOR_OPERATINGSYSTEM
0x00020000
 作業系統問題。
SHTDN_REASON_MAJOR_OTHER
0x00000000
 其他問題。
SHTDN_REASON_MAJOR_POWER
0x00060000
 電源故障。
SHTDN_REASON_MAJOR_SOFTWARE
0x00030000
 軟體問題。
SHTDN_REASON_MAJOR_SYSTEM
0x00050000
 系統失敗。

以下是次要原因旗標。 它們會修改指定的主要原因旗標。 您可以將任何次要原因與任何主要原因搭配使用，但某些組合並不合理。

常數/值 Description
SHTDN_REASON_MINOR_BLUESCREEN
0x0000000F
 藍色螢幕當機事件。
SHTDN_REASON_MINOR_CORDUNPLUGGED
0x0000000b
 拔出。
SHTDN_REASON_MINOR_DISK
0x00000007
 磁碟]。
SHTDN_REASON_MINOR_ENVIRONMENT
0x0000000c
 環境。
SHTDN_REASON_MINOR_HARDWARE_DRIVER
0x0000000d
 司機。
SHTDN_REASON_MINOR_HOTFIX
0x00000011
 熱修正。
SHTDN_REASON_MINOR_HOTFIX_UNINSTALL
0x00000017
 熱修正卸載。
SHTDN_REASON_MINOR_HUNG
0x00000005
 反應 遲鈍。
SHTDN_REASON_MINOR_INSTALLATION
0x00000002
 安裝。
SHTDN_REASON_MINOR_MAINTENANCE
0x00000001
 維護。
SHTDN_REASON_MINOR_MMC
0x00000019
 MMC 問題。
SHTDN_REASON_MINOR_NETWORK_CONNECTIVITY
0x00000014
 網路連線能力。
SHTDN_REASON_MINOR_NETWORKCARD
0x00000009
 網路卡。
SHTDN_REASON_MINOR_OTHER
0x00000000
 其他問題。
SHTDN_REASON_MINOR_OTHERDRIVER
0x0000000e
 其他驅動程式事件。
SHTDN_REASON_MINOR_POWER_SUPPLY
0x0000000a
 電源。
SHTDN_REASON_MINOR_PROCESSOR
0x00000008
 處理器。
SHTDN_REASON_MINOR_RECONFIG
0x00000004
 配置。
SHTDN_REASON_MINOR_SECURITY
0x00000013
 安全性問題。
SHTDN_REASON_MINOR_SECURITYFIX
0x00000012
 安全性修補程式。
SHTDN_REASON_MINOR_SECURITYFIX_UNINSTALL
0x00000018
 安全性修補程式卸載。
SHTDN_REASON_MINOR_SERVICEPACK
0x00000010
 Service Pack。
SHTDN_REASON_MINOR_SERVICEPACK_UNINSTALL
0x00000016
 Service Pack 卸載。
SHTDN_REASON_MINOR_TERMSRV
0x00000020
 終端機服務。
SHTDN_REASON_MINOR_UNSTABLE
0x00000006
 穩定。
SHTDN_REASON_MINOR_UPGRADE
0x00000003
 升級。
SHTDN_REASON_MINOR_WMI
0x00000015
 WMI 問題。

下列選擇性旗標提供事件的其他資訊。

常數/值 Description
SHTDN_REASON_FLAG_USER_DEFINED
0x40000000
 原因程式碼是由使用者所定義。 如需詳細資訊，請參閱定義自訂原因程式碼。
如果這個旗標不存在，則原因程式碼是由系統所定義。
SHTDN_REASON_FLAG_PLANNED
0x80000000
 已規劃關閉。 系統會 (SSD) 檔案產生系統狀態資料。 此檔案包含系統狀態資訊，例如進程、執行緒、記憶體使用量和組態。
如果這個旗標不存在，則關閉是非計劃性的。 通知和報告選項是由一組原則所控制。 例如，登入之後，如果已啟用原則，系統會顯示一個對話方塊，報告非計劃性關機。 只有在系統上啟用 SSD 原則時，才會建立 SSD 檔案。 系統管理員可以使用Windows 錯誤報告將 SSD 資料傳送至中央位置或 Microsoft。

備註

系統可辨識下列組合。 資料表指出關機事件追蹤器中顯示的字串，並提供更詳細的描述。 預設字串為「找不到此原因的標題」。

合併 Description
SHTDN_REASON_MAJOR_APPLICATION |SHTDN_REASON_MINOR_HUNG 「應用程式：無回應」非計劃性重新開機或關機，以針對沒有回應的應用程式進行疑難排解。
SHTDN_REASON_MAJOR_APPLICATION |SHTDN_REASON_MINOR_INSTALLATION |SHTDN_REASON_FLAG_PLANNED 「應用程式：安裝 (計劃性) 」計畫重新開機或關機以執行應用程式安裝。
SHTDN_REASON_MAJOR_APPLICATION |SHTDN_REASON_MINOR_MAINTENANCE 「應用程式：維護 (非計劃性) 」非計劃性重新開機或關閉服務應用程式。
SHTDN_REASON_MAJOR_APPLICATION |SHTDN_REASON_MINOR_MAINTENANCE |SHTDN_REASON_FLAG_PLANNED 「應用程式：維護 (計劃性) 」計劃性重新開機或關機，以對應用程式執行計劃性維護。
SHTDN_REASON_MAJOR_APPLICATION |SHTDN_REASON_MINOR_UNSTABLE 「應用程式：不穩定」非計劃性重新開機或關機，以針對不穩定的應用程式進行疑難排解。
SHTDN_REASON_MAJOR_HARDWARE |SHTDN_REASON_MINOR_INSTALLATION 「硬體：安裝 (非計劃性) 」非計劃性重新開機或關機，以開始或完成硬體安裝。
SHTDN_REASON_MAJOR_HARDWARE |SHTDN_REASON_MINOR_INSTALLATION |SHTDN_REASON_FLAG_PLANNED 「硬體：安裝 (計劃性) 」計畫重新開機或關機，以開始或完成硬體安裝。
SHTDN_REASON_MAJOR_HARDWARE |SHTDN_REASON_MINOR_MAINTENANCE 「硬體：維護 (非計劃性) 」非計劃性重新開機或關機至系統上的服務硬體。
SHTDN_REASON_MAJOR_HARDWARE |SHTDN_REASON_MINOR_MAINTENANCE |SHTDN_REASON_FLAG_PLANNED 「硬體：維護 (計劃性) 」計劃性重新開機或關機，以在系統上服務硬體。
SHTDN_REASON_MAJOR_LEGACY_API 「舊版 API 關機」此關機是由舊版 InitiateSystemShutdown 函式所起始。 應用程式應該使用 InitiateSystemShutdownEx 函式。
SHTDN_REASON_MAJOR_OPERATINGSYSTEM |SHTDN_REASON_MINOR_HOTFIX 「作業系統：非計劃性修正 (非計劃性) 」非計劃性重新開機或關機以安裝經常性修正程式。
SHTDN_REASON_MAJOR_OPERATINGSYSTEM |SHTDN_REASON_MINOR_HOTFIX |SHTDN_REASON_FLAG_PLANNED 「作業系統：熱修正 (計劃性) 」計畫重新開機或關機以安裝熱修正程式。
SHTDN_REASON_MAJOR_OPERATINGSYSTEM |SHTDN_REASON_MINOR_RECONFIG 「作業系統：重新設定 (非計劃性) 」非計劃性重新開機或關機以變更作業系統組態。
SHTDN_REASON_MAJOR_OPERATINGSYSTEM |SHTDN_REASON_MINOR_RECONFIG |SHTDN_REASON_FLAG_PLANNED 「作業系統：重新設定 (計劃性) 」計畫重新開機或關機以變更作業系統設定。
SHTDN_REASON_MAJOR_OPERATINGSYSTEM |SHTDN_REASON_MINOR_SECURITYFIX 「作業系統：安全性修正 (非計劃性) 」非計劃性重新開機或關機以安裝安全性修補程式。
SHTDN_REASON_MAJOR_OPERATINGSYSTEM |SHTDN_REASON_MINOR_SECURITYFIX |SHTDN_REASON_FLAG_PLANNED 「作業系統：安全性修正 (計劃性) 」計劃性重新開機或關機以安裝安全性修補程式。
SHTDN_REASON_MAJOR_OPERATINGSYSTEM |SHTDN_REASON_MINOR_SERVICEPACK |SHTDN_REASON_FLAG_PLANNED 「作業系統：Service Pack (計劃性) 」計畫重新開機或關機以安裝 Service Pack。
SHTDN_REASON_MAJOR_OPERATINGSYSTEM |SHTDN_REASON_MINOR_UPGRADE |SHTDN_REASON_FLAG_PLANNED 「作業系統：升級 (計劃性) 」計畫重新開機或關機以升級作業系統設定。
SHTDN_REASON_MAJOR_OTHER |SHTDN_REASON_MINOR_OTHER 「其他 (非計劃性) 」非計劃性關機或重新開機。
SHTDN_REASON_MAJOR_OTHER |SHTDN_REASON_MINOR_OTHER |SHTDN_REASON_FLAG_PLANNED 「其他 (計劃性) 」計畫關閉或重新開機。
SHTDN_REASON_MAJOR_OTHER |SHTDN_REASON_MINOR_HUNG 「其他失敗：系統沒有回應」系統變得沒有回應。
SHTDN_REASON_MAJOR_POWER |SHTDN_REASON_MINOR_CORDUNPLUGGED 「電源失敗：纜線解除叢集」電腦已取消叢集。
SHTDN_REASON_MAJOR_POWER |SHTDN_REASON_MINOR_ENVIRONMENT 「電源失敗：環境」發生電源中斷。
SHTDN_REASON_MAJOR_SYSTEM |SHTDN_REASON_MINOR_BLUESCREEN 「系統失敗：停止錯誤」電腦顯示藍色螢幕當機事件。
SHTDN_REASON_MAJOR_SYSTEM |SHTDN_REASON_MINOR_NETWORK_CONNECTIVITY 「網路連線中斷 (非計劃性) 」電腦必須因為網路連線問題而關閉。
SHTDN_REASON_MAJOR_SYSTEM |SHTDN_REASON_MINOR_SECURITY 「安全性問題」電腦必須因為安全性問題而關閉。

 

您也可以定義自己的關機原因，並將其新增至登錄。 每個原因程式碼都應該儲存為下列機碼中的登錄值：HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Reliability\UserDefined\< default_system_language_ID >

此機碼包含下列格式的值名稱： xxxxx;nnn;nnnnn。 分號會分隔值名稱的元件。

Xxxxx

下列一到五個控制項旗標 (無法使用其他字元) 。

旗標 描述
P 計劃性關機;否則為非計劃性關機。
C 需要批註。 這個旗標必須搭配 S 使用。
B 需要識別碼。 此旗標必須與 D 搭配使用。
S 顯示預期的關機對話方塊。 必須使用 S、D 或 S 和 D。
D 顯示非預期的關機對話方塊。 必須使用 S、D 或 S 和 D。

 

使用旗標的順序並不重要。 例如，CSP 表示計劃性關機，其中會顯示預期的關機對話方塊，而且需要批註。

nnn

主要原因。 此元件必須是範圍 64-255 中的數位。 範圍 0-63 會保留供系統使用。

nnnnn

次要原因。 此元件必須位於 0-65535 的範圍內。

自訂原因會依主要原因編號在使用者介面中排序，然後依次要原因編號排序。 除非有一個是計劃性，而另一個是非計劃性的原因，否則兩個自訂原因都不能使用相同的主要和次要原因。 否則，系統會使用第一個實例，並忽略其他實例。

每個登錄值的資料都是兩個字串，並以 \n\r 分隔。 第一個字串是要顯示在關機對話方塊中的標題字串，並寫入事件記錄檔。 大小上限為 64 個字元。 標題字串必須是唯一的。 自訂標題不符合系統所定義的標準標題，或另一個自訂標題。 第二個字串是要顯示在關機對話方塊中的描述字串;這是選擇性的。 大小上限為 256 個字元。

規格需求

需求 值
最低支援的用戶端
 Windows XP [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器
 Windows Server 2003 [傳統型應用程式 |UWP 應用程式]
標頭
Reason.h