系統關機原因代碼
exitWindowsEx和InitiateSystemShutdownEx函式會在dwReason參數中使用關機原因代碼。
系統將處理最多MAX_NUM_REASONS原因碼。 MAX_NUM_REASONS是以 reason.h 定義。
以下是主要原因旗標。 它們表示一般問題類型。
| 常數/值 | Description |
|---|---|
|
應用程式問題。 |
|
硬體問題。 |
|
已使用 InitiateSystemShutdown 函式，而不是 InitiateSystemShutdownEx。 |
|
作業系統問題。 |
|
其他問題。 |
|
電源故障。 |
|
軟體問題。 |
|
系統失敗。 |
以下是次要原因旗標。 它們會修改指定的主要原因旗標。 您可以將任何次要原因與任何主要原因搭配使用，但某些組合並不合理。
| 常數/值 | Description |
|---|---|
|
藍色螢幕當機事件。 |
|
拔出。 |
|
磁碟]。 |
|
環境。 |
|
司機。 |
|
熱修正。 |
|
熱修正卸載。 |
|
反應 遲鈍。 |
|
安裝。 |
|
維護。 |
|
MMC 問題。 |
|
網路連線能力。 |
|
網路卡。 |
|
其他問題。 |
|
其他驅動程式事件。 |
|
電源。 |
|
處理器。 |
|
配置。 |
|
安全性問題。 |
|
安全性修補程式。 |
|
安全性修補程式卸載。 |
|
Service Pack。 |
|
Service Pack 卸載。 |
|
終端機服務。 |
|
穩定。 |
|
升級。 |
|
WMI 問題。 |
下列選擇性旗標提供事件的其他資訊。
| 常數/值 | Description |
|---|---|
|
原因程式碼是由使用者所定義。 如需詳細資訊，請參閱定義自訂原因程式碼。 如果這個旗標不存在，則原因程式碼是由系統所定義。 |
|
已規劃關閉。 系統會 (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 應用程式] |
| 標頭 |
|