共用方式為


SDEL 中的屬性令牌

SDEL 語言會使用目標屬性標記來定義目標裝置和計算機的特性。

所有目標的根屬性令牌

下表描述根命名空間中適用於所有目標的屬性。

關鍵字 VARIANT 類型 描述
類型 VT_BSTR 定義目標的類型。 此值可以是 「系統」或「裝置」。

裝置目標的根屬性令牌

下表描述根命名空間中僅適用於裝置類型目標的屬性。

注意

下列大部分屬性都是透過 SetupDi API 從作業系統擷取。 如需此 API 的詳細資訊,請參閱 SetupDiGetDeviceRegistryProperty。

關鍵字 VARIANT 類型 描述
位址 VT_I4 特定類別 (或總線特定) 位址。
BusNumber VT_I4 裝置的總線號碼。
功能 VT_I4 裝置的功能。
字元 VT_I4 DWORD 中裝置特性旗標的位 OR。 (SPDRP_CHARACTERISTICS)
類別 VT_BSTR 裝置的類別。
ClassGUID VT_BSTR 裝置的類別,採用 GUID 格式。 當您使用本地化組建時,請使用這個關鍵詞,而不是 [類別] 字段。
CompatIDs 具有 VT_BSTR 的 VARIANT VT_ARRAY 為此裝置定義的所有相容識別碼。
ConfigFlags VT_I4 裝置的組態旗標。
Description VT_BSTR 裝置描述。
DeviceID VT_BSTR 裝置標識碼,包括裝置的實例標識碼。 此字串是系統中每個裝置的唯一字串。
DeviceStatusString VT_BSTR 在單一字串中同時包含 StatusString 和 ProblemCodeString。
DevInst VT_I4 裝置實例的不透明句柄。
DevType VT_I4 代表裝置的類型。 (SPDRP_DEVTYPE)
DisplayName VT_BSTR 解析為下列屬性中 (從左至右) 找到的第一個值:FriendlyName、Description 或 DeviceID。
驅動程式 VT_BSTR HKLM\System\CurrentControlSet\Control\Class\ 中的索引鍵,保存驅動程序的詳細資訊。
DriverBinaryNames 具有 VT_BSTR 的 VARIANT VT_ARRAY 匯總 UpperClassFilters、UpperFilters、LowerFilters、LowerClassFilters 和 Service 的所有數據。
列舉值 VT_BSTR 裝置列舉值的名稱。 (SPDRP_ENUMERATOR_NAME)
獨佔 VT_I4 數位,指出使用者是否可以獨佔使用裝置。 (SPDRP_EXCLUSIVE)
篩選器 具有 VT_BSTR 的 VARIANT VT_ARRAY 匯總 UpperClassFilters、UpperFilters、LowerFilters 和 LowerClassFilters 中的所有數據。
FriendlyName VT_BSTR 裝置的好記的名稱。
HardwareIDs 具有 VT_BSTR 的 VARIANT VT_ARRAY 為此裝置定義的所有硬體識別碼。
IsAttached VT_BOOL IsPhantom 屬性的相反。 這個關鍵詞相當於 「IsPhantom=False」。。
IsDisableable VT_BOOL 從 [狀態] 旗標中擷取DN_DISABLEABLE旗標。 VARIANT_TRUE值表示裝置宣告可以停用。 此關鍵詞相當於「狀態&0x00002000」。
IsDisabled VT_BOOL 檢查 ProblemCode 屬性中的CM_PROB_DISABLED值。 VARIANT_TRUE值表示裝置已停用,且在使用前必須啟用。 此關鍵詞相當於 「ProblemCode=0x00000016」。。
IsFailedStart VT_BOOL 檢查問題碼旗標的CM_PROB_FAILED_START旗標。 值VARIANT_TRUE表示設備驅動器無法啟動。 此關鍵詞相當於 「ProblemCode=0x0000000A」。
IsFailedInstall VT_BOOL 檢查問題碼旗標的CM_PROB_FAILED_INSTALL旗標。 值VARIANT_TRUE表示裝置驅動程式無法安裝在裝置上。 這個關鍵詞相當於 「ProblemCode=0x0000001C」。。
IsFiltered VT_BOOL 從 [狀態] 旗標中擷取DN_FILTERED旗標。 此關鍵詞相當於「狀態&0x00000800」。
IsManual VT_BOOL 從 [狀態] 旗標中擷取DN_MANUAL旗標。 此關鍵詞相當於「狀態&0x00000010」。
IsMoved VT_BOOL 從狀態旗標中擷取DN_MOVED旗標。 此關鍵詞相當於「狀態&0x00001000」。
IsPhantom VT_BOOL VARIANT_TRUE值表示裝置目前未插入系統或已卸載。
IsRebootNeeded VT_BOOL 從狀態旗標擷取DN_NEED_RESTART旗標。 VARIANT_TRUE值表示裝置的共同安裝程式宣告電腦必須重新啟動,裝置才能完成移除或安裝動作。 此關鍵詞相當於「狀態&0x00000100」。
IsReinstallNeeded VT_BOOL 從 ConfigFlags 屬性擷取CONFIGFLAG_REINSTALL旗標。 值VARIANT_TRUE表示裝置宣告可以移除它。 此關鍵詞相當於 「ConfigFlags&0x00000020」。
IsRemovable VT_BOOL 從狀態旗標擷取DN_REMOVABLE旗標。 值VARIANT_TRUE表示裝置宣告可以移除它。 此關鍵詞相當於「狀態&0x00004000」。
IsRemovePending VT_BOOL 從狀態旗標擷取DN_WILL_BE_REMOVED旗標。 此關鍵詞相當於「狀態&0x00040000」。
IsRootEnumerated VT_BOOL 從狀態旗標擷取DN_ROOT_ENUMERATED旗標。 VARIANT_TRUE值表示裝置的父系為 RootDevice。 此關鍵詞相當於「狀態&0x00000001」。
IsStarted VT_BOOL 從狀態旗標擷取DN_STARTED旗標。 VARIANT_TRUE值表示裝置目前已設定。 此關鍵詞相當於「狀態&0x00000008」。
LegacyBusType VT_I4 舊版總線類型。
位置 VT_BSTR 裝置實體位置的詳細資訊。
LocationPaths 具有 VT_BSTR 的 VARIANT VT_ARRAY 裝置樹狀結構中裝置實例的位置。
LowerClassFilters 具有 VT_BSTR 的 VARIANT VT_ARRAY 每個附加為目標裝置上較低類別篩選的驅動程式服務名稱。
LowerClassFiltersBinaryNames 具有 VT_BSTR 的 VARIANT VT_ARRAY 裝置目標所有較低類別篩選驅動程式的二進位檔名稱。
LowerFilters 具有 VT_BSTR 的 VARIANT VT_ARRAY 每個附加為目標裝置上較低篩選條件的驅動程式服務名稱。
LowerFiltersBinaryNames 具有 VT_BSTR 的 VARIANT VT_ARRAY 裝置目標的所有較低篩選驅動程序名稱。
製造商 VT_BSTR 裝置製造商。
PDO VT_BSTR 核心中實體裝置物件的名稱。
ProblemCode VT_I4 裝置的問題碼。 Cfg.h 中定義的CM_PROB_前置問題值之一。
ProblemCodeString VT_BSTR ProblemCode 的字串表示。
RemovalPolicy VT_I4 裝置目前的移除原則。 (SPDRP_REMOVAL_POLICY)
RemovalPolicyHWDefault VT_I4 裝置的ardware指定預設移除原則。 (SPDRP_REMOVAL_POLICY_HW_DEFAULT)
RemovalPolicyOverride VT_I4 如果裝置) 存在,請覆寫移除原則 (。 (SPDRP_REMOVAL_POLICY_OVERRIDE)
服務 VT_BSTR 裝置驅動程式的服務名稱。
ServiceBinaryName VT_BSTR 裝置目標的函式驅動程序名稱。
狀態 VT_I4 裝置的狀態旗標。
StatusString VT_BSTR 裝置狀態字串。
SymbolicLink VT_BSTR 您可以使用 Microsoft Win32 CreateFile 方法開啟裝置的名稱。 您無法以這種方式使用所有裝置。 大部分具有可程式化介面的裝置都可以使用 SymbolicLink。
UIFormat VT_BSTR 用來顯示UINumber值的字串。 (SPDRP_UI_NUMBER_DESC_FORMAT)
UINumber VT_I4 裝置的UINumber。
UpperClassFilters 具有 VT_BSTR 的 VARIANT VT_ARRAY 每個附加為目標裝置上上層類別篩選的驅動程式服務名稱。
UpperClassFiltersBinaryNames 具有 VT_BSTR 的 VARIANT VT_ARRAY 裝置目標之所有上層篩選驅動程式的二進位檔名稱。
UpperFilters 具有 VT_BSTR 的 VARIANT VT_ARRAY 每個附加為目標裝置上上限篩選的驅動程式服務名稱。
UpperFiltersBinaryNames 具有 VT_BSTR 的 VARIANT VT_ARRAY 裝置目標的所有上層篩選驅動程式名稱

系統目標的根關鍵詞

下表描述根命名空間中的屬性,這些屬性僅適用於系統類型目標。

關鍵字 VARIANT 類型 Description
IsPhantom VT_BOOL 指定系統目前是否可供使用。
IsRemote VT_BOOL 指定目標是否為遠端系統。
PageSize VT_I4 目標系統硬體的頁面大小。
ProcArch VT_BSTR 目標系統硬體的處理器架構。 此欄位可以包含 「x86」、“ IA64 或 「x64」。
OSMajorVersion VT_I4 指定作業系統的主要版本號碼。
OSMinorVersion VT_I4 指定作業系統的次要版本號碼。

磁碟命名空間關鍵詞

下表描述磁碟命名空間中僅適用於磁碟裝置的屬性。

注意

磁碟命名空間中的大部分屬性都是透過IOCTL從作業系統擷取到磁碟本身。 如需詳細資訊,請參閱 STORAGE_DEVICE_DESCRIPTOR

關鍵字 VARIANT 類型 Description
BusType VT_I4 STORAGE_DEVICE_DESCRIPTOR。BusType 欄位。
DeviceType VT_I4 STORAGE_DEVICE_DESCRIPTOR。DeviceTypeModifier 字段。
IsRemovable VT_BOOL 指定裝置是否包含抽取式媒體。
IsCommandQueuing VT_BOOL STORAGE_DEVICE_DESCRIPTOR。CommandQueueing 欄位。
數字 VT_UI4 磁碟編號 (可能與 [位址] 欄位) 相同。
ProductID VT_BSTR 產品識別碼。
ProductRev VT_BSTR 產品修訂值。
SerialNumber VT_BSTR 序列號。
大小 VT_I8 磁碟的總大小,以位元組為單位。
VendorID VT_BSTR 廠商標識碼。

磁碟區命名空間關鍵詞

下表描述磁碟區命名空間中僅適用於磁碟區裝置的屬性。

關鍵字 VARIANT 型別 描述
Boot VT_BOOL 判斷磁碟區是否為開機磁碟分區。 值VARIANT_TRUE表示磁碟區是開機磁碟分區。 開機磁碟分區是包含 Windows 作業系統檔案的磁碟分區。
DeviceName VT_BSTR 此磁碟區 MS-DOS 裝置名稱的目前對應。
磁碟 VT_BSTR 此磁碟區 MS-DOS 裝置名稱的目前對應。
DriveLetter VT_BSTR 磁碟區的驅動器號,包括尾端斜線 (\) 。
ExtentCount VT_I4 磁碟區延伸的磁碟數目。
ExtentDiskNumbers 具有 VT_I4的 VARIANT VT_ARRAY 陣列,其中包含磁碟區延伸的每個 Disk::Number 值。 陣列具有ExtentCount元素,且為0索引。 陣列的排序順序與其他 Extent* 陣列相同。
ExtentLengths 具有 VT_I8的 VARIANT VT_ARRAY 數位,包含磁碟區延伸的每個個別範圍長度。 陣列具有ExtentCount元素,且為0索引。 陣列的排序順序與其他 Extent* 陣列相同。
ExtentOffsets 具有 VT_I8的 VARIANT VT_ARRAY 數位,包含磁碟區所延伸之每個個別範圍的起始位移。 陣列具有ExtentCount元素,且為0索引。 陣列的排序順序與其他 Extent* 陣列相同。
FileSystem VT_BSTR 磁碟區檔案系統的名稱。 (GetVolumeInformation)
FreeSize VT_I8 磁碟區上的可用空間總數,以位元組為單位。
GBFreeSize VT_I4 e 可用磁碟上的可用 GB 總數, (GB) 可供使用者使用。
GBTotalSize VT_I4 使用者可用的磁碟區上, (GB) 的 GB 總數。
HasFiles VT_BOOL 判斷磁碟區上是否有檔案。 值VARIANT_TRUE表示磁碟區上有檔案。
IsMediaPresent VT_BOOL 判斷磁碟區是否存在媒體。 值VARIANT_TRUE表示磁碟區上有媒體。
IsMediaRemovable VT_BOOL 判斷磁碟區媒體是否可移動。 VARIANT_TRUE值表示磁碟區媒體是可移動的。
標籤 VT_BSTR 磁碟區標籤。 (GetVolumeInformation)
MBFreeSize VT_I8 可用磁碟上的可用 MB 總數 (MB) 可供使用者使用。
MBTotalSize VT_I8 可供使用者使用的磁碟區上, (MB) 總數。 (GetDiskFreeSpaceEx)
MountPaths VT_BSTR 此磁碟區的所有掛接路徑。
PagePath VT_BOOL 判斷磁碟區是否包含使用中的頁面檔案。 VARIANT_TRUE值表示磁碟區包含使用中頁面檔案。
SerialNumber VT_I4 磁碟區的序號。
系統 VT_BOOL 判斷磁碟區是否為系統分割區。 VARIANT_TRUE值表示磁碟區包含 Windows 系統磁碟分區。 系統磁碟分區包含 (可開機程式代碼) 的硬體相關檔案,可啟動 Windows 開機管理員 (bootmgr) 。
TotalSize VT_I8 磁碟區的總大小,以位元組為單位。
類型 VT_I4 從 GetDriveType (DriveLetter) 傳回的值。 如需詳細資訊,請參閱 MSDN Library 中的 GetDriveType。

Power Namespace 關鍵詞

下表描述 Power 命名空間中僅適用於電源裝置的屬性。

關鍵字 VARIANT 型別 Description
SupportedDeviceUnits 具有 VT_BSTR 的 VARIANT VT_ARRAY 可供查詢的PowerUnit命名空間陣列。

PowerDevice、PowerComponentX、PowerProcessor 和 PowerSoC 命名空間關鍵詞

下表描述各種PowerUnit命名空間中的屬性。

關鍵字 VARIANT 型別 Description
SupportedStates 具有 VT_BSTR 的 VARIANT VT_ARRAY 電源狀態的命名空間陣列, (C0–C6、D0–D3、F0–F9、SWIS0–SWIS3)
CoveredStates 具有 VT_BSTR 的 VARIANT VT_ARRAY 涵蓋狀態的命名空間陣列。 只包含具有非零點擊計數的狀態

PowerProcessorCX、PowerDeviceDX、PowerComponentXFY、PowerSoCSWISX 命名空間關鍵詞

下表描述各種 PowerState 命名空間中的屬性。

關鍵字 VARIANT 型別 Description
HitCount VT_UI4 測試期間輸入指定電源狀態的次數。
持續時間 VT_UI4 以毫秒為單位的時間週期,花費在指定的電源狀態。
百分比 VT_UI4 他花費在指定電源狀態的時間百分比。

介面命名空間關鍵詞

下表描述各種介面命名空間中的屬性。

關鍵字 VARIANT 型別 描述
全部 VT_BSTR 單一裝置支援的所有裝置介面 GUID 的所有裝置介面。
磁碟區 VT_BSTR GUID_DEVINTERFACE_VOLUME GUID 的介面。
DISK VT_BSTR GUID_DEVINTERFACE_DISK GUID 的介面。
CDROM VT_BSTR GUID_DEVINTERFACE_CDROM GUID 的介面。
GUID VT_BSTR 單一介面 GUID 的介面。

CAP 命名空間關鍵詞

下表描述各種 CAP (Capabilities) 命名空間中的屬性。

關鍵字 VARIANT 型別 Description
LockSupported VT_BOOL 指定裝置是否支援防止裝置退出的實體裝置鎖定。 (CM_DEVCAP_LOCKSUPPORTED)
退出支援 VT_BOOL 指定當系統處於 PowerSystemWorking 狀態時,裝置是否支援軟體控制的裝置退出。 (CM_DEVCAP_EJECTSUPPORTED)
卸除式 VT_BOOL 指定是否可以從其立即父系動態移除裝置。 (CM_DEVCAP_REMOVABLE)
DockDevice VT_BOOL 指定裝置是否為停駐周邊。 (CM_DEVCAP_DOCKDEVICE)
UniqueId VT_BOOL 指定裝置的實例識別碼是否為全系統的唯一標識符。 (CM_DEVCAP_UNIQUEID)
SilentInstall VT_BOOL 指定 裝置管理員 是否應該隱藏所有安裝對話框。 (CM_DEVCAP_SILENTINSTALL)
RawDeviceOK VT_BOOL 指定如果沒有函式驅動程式,基礎總線的驅動程式是否可以驅動裝置。 (CM_DEVCAP_RAWDEVICEOK)
SurpriseRemovalOK VT_BOOL 指定裝置的函式驅動程式是否可以在 Windows 傳送IRP_MN_QUERY_REMOVE_DEVICE給裝置之前,先處理移除裝置的情況。 (CM_DEVCAP_SURPRISEREMOVALOK)
HardwareDisabled VT_BOOL 指定裝置的硬體是否已停用。 (CM_DEVCAP_HARDWAREDISABLED)
NonDynamic VT_BOOL 保留供未來使用。 (CM_DEVCAP_NONDYNAMIC)

INF 命名空間關鍵詞

下表描述各種 INF 命名空間中的屬性。

關鍵字 VARIANT 型別 說明
FileName VT_BSTR INF 檔名。
FileNamePath VT_BSTR INF 檔名路徑。
SectionName VT_BSTR INF 區段名稱。
Date VT_BSTR INF 日期。
OriginalInfFileName VT_BSTR 原始 INF 檔名。

NET 命名空間關鍵詞

下表描述各種 NET 命名空間中的屬性。

關鍵字 VARIANT 型別 說明
AdapterName VT_BSTR IP_ADAPTER_ADDRESSES 結構的 AdapterName 欄位。
IPV6Address VT_BSTR IP_ADAPTER_ADDRESSES 結構的 FirstUnicastAddress 字段。
FirstAnycastAddress VT_BSTR IP_ADAPTER_ADDRESSES 結構的 FirstAnycastAddress 字段。
FirstMulticastAddress VT_BSTR IP_ADAPTER_ADDRESSES 結構的 FirstMulticastAddress 字段。
FirstDnsServerAddress VT_BSTR IP_ADAPTER_ADDRESSES 結構的 FirstDnsServerAddress 字段。
FirstPrefix VT_BSTR IP_ADAPTER_ADDRESSES 結構的 FirstPrefix 欄位。
PrimaryWINSServer VT_BSTR IP_ADAPTER_ADDRESSES 結構的 FirstWinsServerAddress 字段。
FirstGatewayAddress VT_BSTR IP_ADAPTER_ADDRESSES 結構的 FirstGatewayAddress 字段。
ConnectionSpecificDNSSuffix VT_BSTR 來自 IP_ADAPTER_ADDRESSES 結構的 DnsSuffix 欄位
Description VT_BSTR 結構IP_ADAPTER_ADDRESSES的描述欄位。
FriendlyName VT_BSTR IP_ADAPTER_ADDRESSES 結構的FriendlyName欄位。
PhysicalAddress VT_BSTR IP_ADAPTER_ADDRESSES 結構的 MacAddress 欄位
Flags VT_UI4 來自IP_ADAPTER_ADDRESSES結構的旗標欄位
Mtu VT_UI4 IP_ADAPTER_ADDRESSES 結構的 Mtu 欄位。
IfType VT_UI4 來自 IP_ADAPTER_ADDRESSES 結構的 IfType 欄位。
OperStatus VT_UI4 IP_ADAPTER_ADDRESSES 結構的 OperStatus 欄位
OperationalStatusString VT_BSTR 來自 IP_ADAPTER_ADDRESSES 結構的 OperStatus 字段的字串對等專案
Ipv6IfIndex VT_UI4 IP_ADAPTER_ADDRESSES 結構的 Ipv6IfIndex 欄位
TransmitLinkSpeedMbps VT_UI4 來自 IP_ADAPTER_ADDRESSES 結構的 TransmitLinkSpeedGpbs 字段。
ReceiveLinkSpeedMbps VT_UI4 來自 IP_ADAPTER_ADDRESSES 結構的 ReceiveLinkSpeedMbps 字段。
Ipv4Metric VT_UI4 IP_ADAPTER_ADDRESSES 結構的 Ipv4Metric 欄位。
Ipv6Metric VT_UI4 IP_ADAPTER_ADDRESSES 結構的 Ipv6Metric 欄位。
DHCPServer VT_BSTR IP_ADAPTER_ADDRESSES 結構的 Dhcpv4Server 欄位。
CompartmentId VT_UI4 IP_ADAPTER_ADDRESSES 結構的 CompartmentId 欄位。
NetworkGuid VT_BSTR IP_ADAPTER_ADDRESSES 結構的 NetworkGuid 欄位。
ConnectionType VT_UI4 IP_ADAPTER_ADDRESSES 結構的 ConnectionType 欄位。
TunnelType VT_UI4 來自 IP_ADAPTER_ADDRESSES 結構的 TunnelType 欄位。
Dhcpv6ClientDuidLength VT_UI4 來自 IP_ADAPTER_ADDRESSES 結構的 Dhcpv6ClientDuidLength 字段。
Dhcpv6Iaid VT_UI4 IP_ADAPTER_ADDRESSES 結構的 Dhcpv6Iaid 欄位。
IsOperational VT_BOOL 是可操作的。
PhysicalMediaType VT_UI4 網路裝置的實體媒體類型。
MediaType VT_UI4 網路裝置的實體媒體類型。

OpticalMedia 命名空間關鍵詞

下表描述各種 OpticalMedia 命名空間中的屬性。

關鍵字 VARIANT 型別 Description
IsMediaPresent VT_BOOL 如果媒體存在於光學媒體裝置中,則為 。
類型 VT_UI4 從 IOCTL_CDROM_GET_CONFIGURATION 傳回的目前配置檔類型號碼GET_CONFIGURATION_HEADER。
ClassTypeString VT_BSTR 光學媒體類別的類型。
[Type] \(類型\)[String] VT_BSTR 光學媒體的類型。

StorageMedia 命名空間關鍵詞

下表描述各種 StorageMedia 命名空間中的屬性。

關鍵字 VARIANT 型別 Description
DeviceType VT_UI4 指定其中一個系統定義的FILE_DEVICE_XXX常數,指出裝置的類型。
DeviceTypeString VT_BSTR 裝置類型相關聯的字串。
Count VT_UI4 包含 MediaInfo 中的DEVICE_MEDIA_INFO結構數目。
SupportedTypes VT_UI4 指定表示卸除式磁碟類型的所有MEDIA_TYPE或STORAGE_MEDIA_TYPE值。
有效 VT_BOOL 如果此裝置的收集器具有有效的數據。

Windows 命名空間關鍵詞

下表描述各種 Windows 命名空間中的屬性。

關鍵字 VARIANT 型別 Description
IsDriverVerifierEnabled VT_BOOL True 或 False 表示是否針對此裝置的所有驅動程式啟用至少標準設定的驅動程式驗證器。
IsKernelDebugDevice VT_BOOL True 或 False 表示核心調試程式是否正在使用此裝置。