CIM_DeviceFile 類別

發行項
06/12/2023

CIM_DeviceFile類別代表代表裝置的邏輯檔案類型。此慣例適用于使用位元組資料流程 I/O 模型管理裝置的作業系統。與這個檔案相關聯的邏輯裝置是使用 CIM_DeviceAccessedByFile 關聯性來指定。

重要

DMTF (Distributed Management Task Force) CIM (Common Information Model) 類別是 WMI 類別所建置的父類別。 WMI 目前僅支援 CIM 2.x 版本架構。

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

語法

[Abstract, UUID("{4333BD60-E3D1-11d2-8601-0000F8102E5F}"), AMENDMENT]
class CIM_DeviceFile : CIM_LogicalFile
{
  uint32   AccessMask;
  boolean  Archive;
  string   Caption;
  boolean  Compressed;
  string   CompressionMethod;
  string   CreationClassName;
  datetime CreationDate;
  string   CSCreationClassName;
  string   CSName;
  string   Description;
  string   Drive;
  string   EightDotThreeFileName;
  boolean  Encrypted;
  string   EncryptionMethod;
  string   Extension;
  string   FileName;
  uint64   FileSize;
  string   FileType;
  string   FSCreationClassName;
  string   FSName;
  boolean  Hidden;
  datetime InstallDate;
  uint64   InUseCount;
  datetime LastAccessed;
  datetime LastModified;
  string   Name;
  string   Path;
  boolean  Readable;
  string   Status;
  boolean  System;
  boolean  Writeable;
};

成員

CIM_DeviceFile類別具有下列類型的成員：

方法
屬性

方法

CIM_DeviceFile類別具有這些方法。

方法	Description
ChangeSecurityPermissions	變更物件路徑中所指定邏輯檔案的安全性許可權。 WMI 未實作。
ChangeSecurityPermissionsEx	變更物件路徑中所指定邏輯檔案的安全性許可權。 WMI 未實作。
壓縮	壓縮物件路徑中指定的邏輯檔案 (或目錄) 。 WMI 未實作。
CompressEx	壓縮物件路徑中指定的邏輯檔案 (或目錄) 。 WMI 未實作。
複製	將邏輯檔案 (或目錄) 指定于輸入參數所指定的位置複製。 WMI 未實作。
CopyEx	將邏輯檔案 (或目錄) 指定于輸入參數所指定的位置複製。 WMI 未實作。
刪除	刪除物件路徑中指定的邏輯檔案 (或目錄) 。 WMI 未實作。
DeleteEx	刪除物件路徑中指定的邏輯檔案 (或目錄) 。 WMI 未實作。
GetEffectivePermission	判斷呼叫端是否具有 Permission 引數所指定的匯總許可權。 WMI 未實作。
重命名	重新命名物件路徑中指定的邏輯檔案 (或目錄) 。 WMI 未實作。
TakeOwnerShip	取得物件路徑中指定的邏輯檔案擁有權。 WMI 未實作。
TakeOwnerShipEx	取得物件路徑中指定的邏輯檔案擁有權。 WMI 未實作。
取消壓縮	取消壓縮物件路徑中指定的邏輯檔案 (或目錄) 。 WMI 未實作。
UncompressEx	取消壓縮物件路徑中指定的邏輯檔案 (或目錄) 。 WMI 未實作。

屬性

CIM_DeviceFile類別具有這些屬性。

AccessMask

資料類型： uint32
存取類型：唯讀
限定詞：架構 (「Win32」) ， DisplayName (「Access Rights」)

位陣列，表示代表傳回實例之使用者或群組所持有之指定檔案或目錄的存取權限。在 FAT 磁片區上， 會傳回FULL_ACCESS ，這表示物件上未設定任何安全性。

此屬性繼承自 CIM_LogicalFile。

FILE_READ_DATA (檔案) 或FILE_LIST_DIRECTORY (目錄) (1)

授與從檔案讀取資料的許可權。對於目錄，這個值會授與列出目錄內容的許可權。

FILE_WRITE_DATA (檔案) 或FILE_ADD_FILE (目錄) (2)

授與將資料寫入檔案的許可權。對於目錄，這個值會授與在目錄中建立檔案的許可權。

FILE_APPEND_DATA (檔案) 或FILE_ADD_SUBDIRECTORY (目錄) (4)

授與將資料附加至檔案的許可權。對於目錄，這個值會授與建立子目錄的許可權。

FILE_READ_EA (8)

授與讀取擴充屬性的許可權。

FILE_WRITE_EA (16)

授與寫入擴充屬性的許可權。

FILE_EXECUTE (檔案) 或FILE_TRAVERSE (目錄) (32)

授與執行檔案的許可權。針對目錄，可以周遊目錄。

FILE_DELETE_CHILD (目錄) (64)

授與刪除目錄的許可權及其包含的所有檔案 (其子系) ，即使檔案是唯讀的。

FILE_READ_ATTRIBUTES (128)

授與讀取檔案屬性的許可權。

FILE_WRITE_ATTRIBUTES (256)

授與變更檔案屬性的許可權。

DELETE (65536)

授與刪除存取權。

READ_CONTROL (131072)

授與安全性描述元和擁有者的讀取權限。

WRITE_DAC (262144)

授與任意 ACL 的寫入權限。

WRITE_OWNER (524288)

指派寫入擁有者。

同步處理 (1048576)

同步存取，並允許進程等候物件進入訊號狀態。

封存

資料類型： 布林值
存取類型：唯讀
限定詞：架構 (「Win32」) ， DisplayName (「應該封存」)

如果 為 True，則應該封存檔案。

此屬性繼承自 CIM_LogicalFile。

標題

資料類型：字串
存取類型：唯讀
限定詞： MaxLen (64) 、 DisplayName (「Caption」)

物件的簡短文字描述。

此屬性繼承自 CIM_ManagedSystemElement。

Compressed

資料類型： 布林值
存取類型：唯讀
限定詞：架構 (「Win32」) ， DisplayName (「Compressed」)

如果 為 True，則會壓縮檔案。

此屬性繼承自 CIM_LogicalFile。

CompressionMethod

資料類型：字串
存取類型：唯讀
限定詞： DisplayName (「Compression 方法」)

自由格式字串，表示用來壓縮邏輯檔案的演算法或工具。如果壓縮配置未知或未描述，請使用「未知」。如果邏輯檔案已壓縮，但壓縮配置未知或未描述，請使用「Compressed」。如果未壓縮邏輯檔案，請使用「未壓縮」。

此屬性繼承自 CIM_LogicalFile。

CreationClassName

資料類型：字串
存取類型：唯讀
限定詞： CIM_Key、 DisplayName (「類別名稱」)

類別的名稱。

此屬性繼承自 CIM_LogicalFile。

CreationDate

資料類型： datetime
存取類型：唯讀
限定詞： DisplayName (「建立日期」)

檔案的建立日期。

此屬性繼承自 CIM_LogicalFile。

CSCreationClassName

資料類型：字串
存取類型：唯讀
限定詞：傳播 (「CIM_FileSystem。CSCreationClassName「) ， CIM_Key， DisplayName (」電腦系統類別名稱「)

電腦系統的類別。

此屬性繼承自 CIM_LogicalFile。

CSName

資料類型：字串
存取類型：唯讀
限定詞：傳播 (「CIM_FileSystem。CSName「) ， CIM_Key， DisplayName (」電腦系統名稱「)

電腦系統的名稱。

此屬性繼承自 CIM_LogicalFile。

說明

資料類型：字串
存取類型：唯讀
限定詞： DisplayName (「Description」)

物件的文字描述。

此屬性繼承自 CIM_ManagedSystemElement。

磁碟機

資料類型：字串
存取類型：唯讀
限定詞：固定 的架構 (「Win32」) ，DisplayName (「Drive」)

磁碟機號 (包含檔案) 磁碟機號之後的冒號。此屬性繼承自 CIM_LogicalFile。

範例：「c：」

EightDotThreeFileName

資料類型：字串
存取類型：唯讀
限定詞：架構 (「Win32」) ， DisplayName (「八點三檔案名」)

檔案的 DOS 相容檔案名。此屬性繼承自 CIM_LogicalFile。

範例：「c：\progra~1」

已加密

資料類型： 布林值
存取類型：唯讀
限定詞：架構 (「Win32」) 、 DisplayName (「Encrypted」)

如果 為 True，則會加密檔案。

此屬性繼承自 CIM_LogicalFile。

EncryptionMethod

資料類型：字串
存取類型：唯讀
限定詞： DisplayName (「Encryption 方法」)

可識別用來加密邏輯檔案之演算法或工具的免費格式字串。如果基於安全性考慮而未 (加密配置，例如) ，請使用「Unknown」。如果檔案已加密，但其加密配置未知或未揭露，請使用「Encrypted」。如果邏輯檔案未加密，請使用「未加密」。

此屬性繼承自 CIM_LogicalFile。

副檔名

資料類型：字串
存取類型：唯讀
限定詞：固定的架構 (「Win32」) ， DisplayName (「副檔名」)

不含前一個句點 (點) 的副檔名。

此屬性繼承自 CIM_LogicalFile。

範例：「txt」、「mof」、「mdb」

FileName

資料類型：字串
存取類型：唯讀
限定詞： 已修正、架構 (「Win32」) 、 DisplayName (「檔案名」)

沒有副檔名的檔案名。

此屬性繼承自 CIM_LogicalFile。

範例：「MyDataFile」

FileSize

資料類型： uint64
存取類型：唯讀
限定詞： DisplayName (「Size」) ， Units (「bytes」)

檔案大小，以位元組為單位。

此屬性繼承自 CIM_LogicalFile。

如需在腳本中使用 uint64 值的詳細資訊，請參閱 WMI 中的腳本。

FileType

資料類型：字串
存取類型：唯讀
限定詞：架構 (「Win32」) ， DisplayName (「檔案類型」)

描述項，表示 Extension 屬性所指示的檔案類型 () 。

此屬性繼承自 CIM_LogicalFile。

FSCreationClassName

資料類型：字串
存取類型：唯讀
限定詞：傳播 (「CIM_FileSystem。CreationClassName「) ， CIM_Key， DisplayName (」檔案系統類別名稱「)

檔案系統的類別。

此屬性繼承自 CIM_LogicalFile。

FSName

資料類型：字串
存取類型：唯讀
限定詞：傳播 (「CIM_FileSystem。Name「) ， CIM_Key， DisplayName (」File System Name「)

檔案系統的名稱。

此屬性繼承自 CIM_LogicalFile。

Hidden

資料類型： 布林值
存取類型：唯讀
限定詞：架構 (「Win32」) ， DisplayName (「Hidden」)

如果 為 True，則會隱藏檔案。

此屬性繼承自 CIM_LogicalFile。

InstallDate

資料類型： datetime
存取類型：唯讀
限定詞： MappingStrings (「MIF。DMTF|ComponentID|001.5「) ， DisplayName (」Install Date「)

安裝物件的日期和時間。這個屬性不需要值來表示已安裝物件。

此屬性繼承自 CIM_ManagedSystemElement。

InUseCount

資料類型： uint64
存取類型：唯讀
限定詞： DisplayName (「目前的檔案開啟計數」)

目前對檔案使用中的「檔案開啟」數目。

此屬性繼承自 CIM_LogicalFile。

如需在腳本中使用 uint64 值的詳細資訊，請參閱 WMI 中的腳本。

LastAccessed

資料類型： datetime
存取類型：唯讀
限定詞： DisplayName (「Last Accessed」)

上次存取檔案的日期和時間。

此屬性繼承自 CIM_LogicalFile。

LastModified

資料類型： datetime
存取類型：唯讀
限定詞： DisplayName (「Last Modified」)

上次修改檔案的日期和時間。

此屬性繼承自 CIM_LogicalFile。

名稱

資料類型：字串
存取類型：唯讀
限定詞：金鑰

繼承的名稱，做為檔案系統內邏輯檔實例的索引鍵， (提供完整路徑名稱) 。

此屬性繼承自 CIM_ManagedSystemElement。

範例：「C:\Windows\system\win.ini」

路徑

資料類型：字串
存取類型：唯讀
限定詞：固定 的架構 (「Win32」) ，DisplayName (「Path」)

檔案的路徑，包括前置和尾端反斜線。此屬性繼承自 CIM_LogicalFile。

範例：「\windows\system\」

讀

資料類型： 布林值
存取類型：唯讀
限定詞： DisplayName (「Readable」)

如果 為 True，則可以讀取檔案。

此屬性繼承自 CIM_LogicalFile。

狀態

資料類型：字串
存取類型：唯讀
限定詞： MaxLen (10) 、 DisplayName (「Status」)

字串，表示物件的目前狀態。可以定義作業和非操作狀態。作業狀態可以包含「確定」、「已降級」和「預先失敗」。「預先失敗」表示元素正常運作，但預測失敗 (例如啟用 SMART 的硬碟) 。

非操作狀態可以包含「錯誤」、「啟動」、「停止」和「服務」。「服務」可以在磁片鏡像重新儲存、重載使用者權限清單或其他系統管理工作期間套用。並非所有這類工作都在線上，但 Managed 元素既不是「OK」，也不是處於其他狀態之一。

此屬性繼承自 CIM_ManagedSystemElement。

包括下列值：

OK (「OK」)

錯誤 (「錯誤」)

降級 (「已降級」)

未知 (「未知」)

預先失敗 (「預先失敗」)

開始 (「開始」)

停止 (「停止」)

服務 (「服務」)

壓力 (「壓力」)

NonRecover (「NonRecover」)

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

Lost Comm (「Lost Comm」)

系統

資料類型： 布林值
存取類型：唯讀
限定詞：架構 (「Win32」) 、 DisplayName (「System File」)

如果 為 True，則表示檔案為系統檔案。

此屬性繼承自 CIM_LogicalFile。

可寫入

資料類型： 布林值
存取類型：唯讀
限定詞： DisplayName (「Writeable」)

如果 為 True，則可以寫入檔案。

此屬性繼承自 CIM_LogicalFile。

備註

CIM_DeviceFile類別衍生自CIM_LogicalFile。

WMI 不會實作這個類別。

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

規格需求

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

另請參閱

CIM_LogicalFile

共用方式為

CIM_DeviceFile 類別

語法

成員

方法

屬性

備註

規格需求

另請參閱

意見反應

其他資源