CIM_LogicalDevice 類別 (CIMWin32 WMI 提供者)

CIM _ LogicalDevice 類別代表可能或可能不會在實體硬體中實現的硬體實體。

重要

DMTF (分散式管理工作強制) CIM (通用訊息模型) 類別是用來建立 WMI 類別的父類別。 WMI 目前僅支援 CIM 2.x 版的架構

下列語法已從受管理物件格式 (MOF) 程式碼加以簡化,並包含所有繼承的屬性。 屬性會依字母順序列出,而不是依 MOF 順序列出。

語法

[Abstract, UUID("{8502C529-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class CIM_LogicalDevice : CIM_LogicalElement
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Name;
  string   Status;
  uint16   Availability;
  uint32   ConfigManagerErrorCode;
  boolean  ConfigManagerUserConfig;
  string   CreationClassName;
  string   DeviceID;
  uint16   PowerManagementCapabilities[];
  boolean  ErrorCleared;
  string   ErrorDescription;
  uint32   LastErrorCode;
  string   PNPDeviceID;
  boolean  PowerManagementSupported;
  uint16   StatusInfo;
  string   SystemCreationClassName;
  string   SystemName;
};

成員

CIM _ LogicalDevice 類別具有下列類型的成員:

方法

CIM _ LogicalDevice 類別具有這些方法。

方法 描述
重設 要求重設邏輯裝置。 不是由 WMI 所執行。
SetPowerState 定義邏輯裝置的預期電源狀態,以及何時應將裝置置於該狀態。 不是由 WMI 所執行。

屬性

CIM _ LogicalDevice 類別具有這些屬性。

可用性

資料類型: uint16

存取類型:唯讀

限定詞: MappingStrings ( "MIF。DMTF | 操作狀態 | 003.5 "," MIB。IETF | 主機-RESOURCES-hrDeviceStatus ")

裝置的可用性和狀態。

其他 (1)

未知 的 (2)

執行中 /完整電源 (3)

警告 (4)

在測試 (5)

不適用 (6)

關閉 (7) 的電源

Off 行 (8)

Off (9)

(10) 降級

未安裝 (11)

安裝錯誤 (12)

電-未知的 (13)

裝置已知處於省電模式,但其確切狀態不明。

電-低電源模式 (14)

裝置處於省電狀態,但仍在運作中,而且可能會出現效能降低的情況。

電-待命 (15)

裝置無法正常運作,但可快速進入完整電源。

(16) 的 電源週期

電-警告 (17)

裝置處於警告狀態,但也處於省電模式。

暫停 (18)

裝置已暫停。

未就緒 (19)

裝置未就緒。

未設定 (20)

裝置未設定。

靜止 (21)

裝置為靜音。

標題

資料類型: 字串

存取類型:唯讀

限定詞: MaxLen (64) , DisplayName ( "Caption" )

物件的簡短文字描述。

這個屬性繼承自 CIM _ ManagedSystemElement

ConfigManagerErrorCode

資料類型: uint32

存取類型:唯讀

限定詞: 架構 ( "Win32" )

Win32 設定管理員錯誤碼。

此裝置運作正常。 (0)

這個裝置並未正確設定。 (1)

Windows 無法載入此裝置的驅動程式。 (2)

這個裝置的驅動程式可能已損毀,或您系統的記憶體或其他資源可能不足。 (3)

此裝置無法正常運作。其中一個驅動程式或您的登錄可能已損毀。 (4)

此裝置的驅動程式需要 Windows 無法管理的資源。 (5)

此裝置的開機設定與其他裝置發生衝突。 (6)

無法篩選。 (7)

裝置的驅動程式載入器已遺失。 (8)

此裝置無法正常運作,因為控制固件未正確報告裝置的資源。 (9)

這個裝置無法啟動。 (10)

此裝置失敗。 (11)

這個裝置沒有足夠資源可供使用。 (12)

Windows 無法驗證此裝置的資源。 (13)

在您重新開機電腦之前,此裝置無法正常運作。 (14)

此裝置無法正常運作,因為可能有重新列舉的問題。 (15)

Windows 無法識別這個裝置所使用的所有資源。 (16)

此裝置要求的資源類型不明。 (17)

重新安裝這個裝置的驅動程式。 (18)

使用 VxD 載入器失敗。 (19)

您的登錄可能已損毀。 (20)

系統失敗:嘗試變更此裝置的驅動程式。如果無法運作,請參閱您的硬體檔。Windows 正在移除此裝置。 (21)

這個裝置已停用。 (22)

系統失敗:嘗試變更此裝置的驅動程式。如果無法運作,請參閱您的硬體檔。 (23)

這個裝置可能不存在、運作不正確、或並未安裝所有的驅動程式。 (24)

Windows 仍在設定此裝置。 (25)

Windows 仍在設定此裝置。 (26)

此裝置沒有有效的記錄檔設定。 (27)

這個裝置的驅動程式尚未安裝。 (28)

此裝置已停用,因為裝置的固件未提供所需的資源。 (29)

此裝置正在使用其他裝置正在使用的插斷要求 (IRQ) 資源。 (30)

這個裝置並未正確執行,因為 Windows 無法載入這個裝置必需的驅動程式。 (31)

ConfigManagerUserConfig

資料類型: 布林值

存取類型:唯讀

限定詞: 架構 ( "Win32" )

為 TRUE,則裝置會使用使用者定義的設定。

CreationClassName

資料類型: 字串

存取類型:唯讀

限定詞: CIM _ 金鑰

建立實例時所使用之類別或子類別的名稱。 搭配類別的其他索引鍵屬性使用時,此屬性可讓類別和其子類別的所有實例都能唯一識別。

說明

資料類型: 字串

存取類型:唯讀

限定詞: DisplayName ( "Description" )

物件的文字描述。

這個屬性繼承自 CIM _ ManagedSystemElement

DeviceID

資料類型: 字串

存取類型:唯讀

限定詞: CIM _ 金鑰

用來唯一命名邏輯裝置的位址或其他識別資訊。

ErrorCleared

資料類型: 布林值

存取類型:唯讀

為 TRUE,則表示 LastErrorCode 屬性中報告的錯誤現在已清除。

ErrorDescription

資料類型: 字串

存取類型:唯讀

自由格式的字串,提供 LastErrorCode 屬性中所記錄之錯誤的相關資訊,以及要執行的更正動作。

InstallDate

資料類型: datetime

存取類型:唯讀

限定詞: MappingStrings ( "MIF。DMTF | 元件 | 001.5 ") , DisplayName (" 安裝日期 ")

指出物件的安裝時間。 缺少值並不表示物件未安裝。

這個屬性繼承自 CIM _ ManagedSystemElement

LastErrorCode

資料類型: uint32

存取類型:唯讀

邏輯裝置所報告的最後一個錯誤碼。

名稱

資料類型: 字串

存取類型:唯讀

限定詞: DisplayName ( "Name" )

已知物件的標籤。 子類別化時,可以將這個屬性覆寫為索引鍵屬性。

這個屬性繼承自 CIM _ ManagedSystemElement

PNPDeviceID

資料類型: 字串

存取類型:唯讀

限定詞: 架構 ( "Win32" )

指出邏輯裝置的 Win32 隨插即用裝置識別碼。

範例: " * PNP030b"

PowerManagementCapabilities

資料類型: uint16 陣列

存取類型:唯讀

指出邏輯裝置的特定電源相關功能。

未知 的 (0)

電源相關的容量未知。

不支援 (1)

此裝置不支援與電源相關的容量。

已停用 (2)

電源相關容量已停用。

已啟用 (3)

電源管理功能目前已啟用,但實際的功能組不明,或資訊無法使用。

自動輸入的省電模式 (4)

裝置可以根據使用方式或其他準則來變更其電源狀態。

設定的電源狀態 (5)

支援 SetPowerState 方法。 這個方法可在父 CIM _ LogicalDevice 類別上找到,並且可以實作為。 如需詳細資訊,請參閱 設計受控物件格式 (MOF) 類別

支援 (6) 的 電源迴圈

您可以叫用 SetPowerState 方法,並將 >powerstate 參數設定為 5 ( 「電源週期」 ) 。

支援的 (7) 上的電源已超時

您可以叫用 SetPowerState 方法,並將 >powerstate 參數設定為 5 ( 「電源週期」 ) ,並將 時間 參數設定為特定日期和時間(或間隔),以進行電源開啟。

PowerManagementSupported

資料類型: 布林值

存取類型:唯讀

為 TRUE,則裝置可以受電源管理,也就是進入省電狀態。 如果 為 FALSE,則整數值 1 ( 「不支援」 ) 應該是 PowerManagementCapabilities 陣列中的唯一專案。

這個屬性不會指出電源管理功能目前是否已啟用,或啟用時支援哪些功能。 如需詳細資訊,請參閱 PowerManagementCapabilities 陣列。

狀態

資料類型: 字串

存取類型:唯讀

限定詞: MaxLen (10) , DisplayName ( "Status" )

表示物件目前狀態的字串。 您可以定義操作和非運作狀態。 操作狀態可以包含「確定」、「降級」和「Pred 失敗」。 「Pred 失敗」表示專案正常運作,但正在預測失敗 (例如,啟用智慧型硬碟) 。

非操作狀態可能包括「錯誤」、「開始」、「正在停止」和「服務」。 「服務」可以在磁片鏡像重新同步處理、重載使用者權限清單或其他系統管理工作時套用。 並非所有這類工作都在線上,但是受控元素不是「確定」,也不是其中一個其他狀態。

這個屬性繼承自 CIM _ ManagedSystemElement

包括下列值:

確定 ( [確定] )

錯誤 ( 「錯誤」 )

降級 ( 「降級」 )

未知 的 ( 「未知」 )

Pred 失敗 ( 「Pred 失敗」 )

開始 ( 「開始」 )

停止 ( 「正在停止」 )

服務 ( 「服務」 )

壓力 ( 「壓力」 )

NonRecover ( "NonRecover" )

沒有連絡人 ( 「沒有連絡人」 )

遺失的 comm ( 「遺失的通訊」 )

StatusInfo

資料類型: uint16

存取類型:唯讀

限定詞: MappingStrings ( "MIF。DMTF | 操作狀態 | 003.3 ")

邏輯裝置的狀態。 如果此屬性不適用於邏輯裝置,則應該使用值 5 ( 「不適用」 ) 。

其他 (1)

未知 的 (2)

已啟用 (3)

已停用 (4)

不適用 (5)

SystemCreationClassName

資料類型: 字串

存取類型:唯讀

限定詞: 傳播 ( 「CIM _ 系統」。CreationClassName") , CIM _ 金鑰

範圍系統的建立類別名稱。

SystemName

資料類型: 字串

存取類型:唯讀

限定詞: 傳播 ( 「CIM _ 系統」。名稱") , CIM _ 金鑰

範圍系統的名稱。

備註

管理作業或設定的邏輯裝置特性包含在 CIM _ LogicalDevice 物件中或與之相關聯。 例如,印表機操作屬性是支援的紙張大小或偵測到的錯誤。 例如,感應器裝置設定屬性是閾值設定。 邏輯裝置的各種設定都可以存在,而且會包含在與邏輯裝置相關聯的 CIM _ 設定 物件中。

Cim _ LogicalDevice 類別衍生自 cim _ LogicalElement

WMI 不會執行這個類別。 針對衍生自 CIM _ LogicalDevice 的類別,請參閱 Win32 類別

此檔衍生自 DMTF 所發佈的 CIM 類別描述。 Microsoft 可能已進行變更,以更正次要錯誤、符合 Microsoft SDK 檔標準,或提供詳細資訊。

規格需求

需求
最低支援的用戶端
Windows Vista
最低支援的伺服器
Windows Server 2008
命名空間
根 \ CIMV2
MOF
CIMWin32 mof
DLL
CIMWin32.dll

另請參閱

CIM _ LogicalElement