共用方式為


系統關機原因代碼

exitWindowsExInitiateSystemShutdownEx函式會在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