Win32_PageFile類別

發行項
06/03/2023

Win32_PageFileWMI 類別代表用來處理 Win32 系統上虛擬記憶體檔案交換的檔案。這個類別已被取代。

下列語法已經過受管理物件格式 (MOF) 程式碼簡化，並包含所有已繼承的屬性。屬性和方法依字母順序排列，而非 MOF 順序。

語法

[DEPRECATED, Dynamic, Provider("CIMWin32"), Privileges("SeCreatePagefilePrivilege"), UUID("{8502C4C6-5FBB-11D2-AAC1-006008C78BC7}"), SupportsCreate, CreateBy("PutInstance"), SupportsDelete, DeleteBy("DeleteInstance"), SupportsUpdate, AMENDMENT]
class Win32_PageFile : CIM_DataFile
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  boolean  Archive;
  boolean  Compressed;
  string   CompressionMethod;
  string   CreationClassName;
  datetime CreationDate;
  string   CSCreationClassName;
  string   CSName;
  string   Drive;
  string   EightDotThreeFileName;
  boolean  Encrypted;
  string   EncryptionMethod;
  string   Extension;
  string   FileName;
  uint64   FileSize;
  string   FileType;
  string   FSCreationClassName;
  string   FSName;
  boolean  Hidden;
  uint64   InUseCount;
  datetime LastAccessed;
  datetime LastModified;
  string   Path;
  boolean  Readable;
  boolean  System;
  boolean  Writeable;
  uint32   AccessMask;
  string   Manufacturer;
  string   Status;
  string   Version;
  uint32   FreeSpace;
  uint32   InitialSize;
  uint32   MaximumSize;
  string   Name;
};

成員

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

方法
屬性

方法

Win32_PageFile類別具有這些方法。

方法	Description
ChangeSecurityPermissions	變更物件路徑中所指定之邏輯檔案之安全性許可權的類別方法。
ChangeSecurityPermissionsEx	變更物件路徑中所指定之邏輯檔案之安全性許可權的類別方法。
壓縮	類別方法，可壓縮物件路徑中指定的邏輯檔案 (或目錄) 。
CompressEx	類別方法，可壓縮物件路徑中指定的邏輯檔案 (或目錄) 。
複製	類別方法，會將物件路徑中指定的邏輯檔案或目錄複寫到輸入參數所指定的位置。
CopyEx	類別方法，會將物件路徑中指定的邏輯檔案或目錄複寫到 FileName 參數所指定的位置。
刪除	類別方法，刪除物件路徑中指定的邏輯檔案 (或目錄) 。
DeleteEx	類別方法，刪除物件路徑中指定的邏輯檔案 (或目錄) 。
GetEffectivePermission	類別方法，判斷呼叫端是否具有 Permission 引數所指定的匯總許可權，而不只是在檔案物件上，而是位於檔案或目錄的共用上，如果檔案位於共用) ，則位於 (。
重命名	類別方法，將邏輯檔案重新命名為物件路徑中指定的 (或目錄) 。
TakeOwnerShip	類別方法，可取得物件路徑中指定的邏輯檔案擁有權。
TakeOwnerShipEx	類別方法，可取得物件路徑中指定的邏輯檔案擁有權。
取消壓縮	將邏輯檔案取消壓縮 (或目錄的類別方法，) 指定于物件路徑中。
UncompressEx	將邏輯檔案取消壓縮 (或目錄的類別方法，) 指定于物件路徑中。

屬性

Win32_PageFile類別具有這些屬性。

AccessMask

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

位元遮罩，表示存取或對檔案執行特定作業所需的存取權限。如需值，請參閱 檔案和目錄存取權限常數。

此屬性繼承自 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)

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 方法」)

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

此屬性繼承自 CIM_LogicalFile。

CreationClassName

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

類別的名稱。

此屬性繼承自 CIM_LogicalFile。

CreationDate

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

檔案建立的日期和時間。

此屬性繼承自 CIM_LogicalFile。

CSCreationClassName

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

電腦系統的類別。

此屬性繼承自 CIM_LogicalFile。

CSName

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

電腦系統的名稱。

此屬性繼承自 CIM_LogicalFile。

說明

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

物件的文字描述。

此屬性繼承自 CIM_ManagedSystemElement。

磁碟機

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

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

範例：「c：」

此屬性繼承自 CIM_LogicalFile。

EightDotThreeFileName

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

DOS 相容的檔案名。

範例：「c：\progra~1」

此屬性繼承自 CIM_LogicalFile。

已加密

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

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

此屬性繼承自 CIM_LogicalFile。

EncryptionMethod

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

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

此屬性繼承自 CIM_LogicalFile。

副檔名

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

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

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

此屬性繼承自 CIM_LogicalFile。

FileName

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

沒有副檔名的檔案名。範例：「MyDataFile」

此屬性繼承自 CIM_LogicalFile。

FileSize

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

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

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

此屬性繼承自 CIM_LogicalFile。

FileType

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

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

此屬性繼承自 CIM_LogicalFile。

FreeSpace

資料類型： uint32
存取類型：唯讀
限定詞： 已淘汰、 MappingStrings (「Win32API|記憶體管理結構 |MEMORYSTATUS|dwAvailPageFile「) ， Units (」mb「)

分頁檔案中可用的空間。作業系統可以視需要放大分頁檔案，最多可達使用者所加加的限制。此屬性顯示目前認可記憶體的大小與分頁檔案目前大小之間的差異;它不會顯示分頁檔案的最大可能大小。

FSCreationClassName

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

檔案系統的類別。

此屬性繼承自 CIM_LogicalFile。

FSName

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

檔案系統的名稱。

此屬性繼承自 CIM_LogicalFile。

Hidden

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

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

此屬性繼承自 CIM_LogicalFile。

InitialSize

資料類型： uint32
存取類型：唯讀
限定詞： 已淘汰、 MappingStrings (「Win32Regstry|System\\CurrentControlSet\\Control\\Session Manager\\Memory Management|PagingFiles「) ， Units (」mb「)

頁面檔案的初始大小。

InstallDate

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

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

此屬性繼承自 CIM_ManagedSystemElement。

InUseCount

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

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

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

此屬性繼承自 CIM_LogicalFile。

LastAccessed

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

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

此屬性繼承自 CIM_LogicalFile。

LastModified

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

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

此屬性繼承自 CIM_LogicalFile。

製造商

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

如果有) ，則來自版本資源的製造商字串 (。

此屬性繼承自 CIM_DataFile。

MaximumSize

資料類型： uint32
存取類型：唯讀
限定詞： 已淘汰、 MappingStrings (「Win32API|記憶體管理結構 |MEMORYSTATUS|dwTotalPageFile「) ，單位 (」MB「)

使用者所設定的頁面檔案大小上限。作業系統不允許頁面檔案超過此限制。

名稱

資料類型：字串
存取類型：唯讀
限定詞： 已淘汰、覆寫 (「Name」) 、 MappingStrings (「Win32DLL|NTDLL.DLL|NtQuerySystemInformation|SystemPageFileInformation|PageFileName「)

頁面檔案的名稱。

範例：「C:\PAGEFILE.SYS」

路徑

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

檔案的路徑，包括前置和尾端反斜線。

範例：「\windows\system\」

此屬性繼承自 CIM_LogicalFile。

讀

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

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

此屬性繼承自 CIM_LogicalFile。

狀態

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

字串，表示物件的目前狀態。

此屬性繼承自 CIM_ManagedSystemElement。

包括下列值：

OK (「OK」)

錯誤 (「錯誤」)

降級 (「已降級」)

未知 (「未知」)

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

開始 (「開始」)

停止 (「停止」)

服務 (「服務」)

壓力 (「壓力」)

NonRecover (「NonRecover」)

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

Lost Comm (「Lost Comm」)

系統

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

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

此屬性繼承自 CIM_LogicalFile。

版本

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

如果有版本資源存在， (版本資源中的版本字串) 。

此屬性繼承自 CIM_DataFile。

可寫入

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

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

此屬性繼承自 CIM_LogicalFile。

備註

Win32_PageFile類別衍生自CIM_Directory。

範例

下列 VBScript 程式碼範例示範如何從 Win32_PageFile實例擷取頁面檔案統計資料。

Set PageFileSet = GetObject("winmgmts:").InstancesOf ("Win32_PageFile")

for each PageFile in PageFileSet
 WScript.Echo PageFile.Name & Chr(13) 
 WScript.Echo " Initial: " & PageFile.InitialSize & " MB"
 WScript.Echo " Max: " & PageFile.MaximumSize & " MB" 

next

下列 Perl 程式碼範例示範如何從 Win32_PageFile實例擷取頁面檔案統計資料。

use strict;
use Win32::OLE;

my $PageFileSet;

eval { $PageFileSet = Win32::OLE->GetObject("winmgmts:{impersonationLevel=impersonate}!\\\\.\\root\\cimv2")->
 InstancesOf ("Win32_PageFile"); };
if (!$@ && defined $PageFileSet)
{
 foreach my $PageFileInst (in $PageFileSet)
 {
  print "\n$PageFileInst->{Name}\n";
  print " Initial: $PageFileInst->{InitialSize} MB\n";
  print " Maximum: $PageFileInst->{MaximumSize} MB\n";
 }
}
else
{
 print STDERR Win32::OLE->LastError, "\n";
}

規格需求

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

另請參閱

CIM_DataFile
作業系統類別

共用方式為

Win32_PageFile類別

語法

成員

方法

屬性

備註

範例

規格需求

另請參閱

意見反應

其他資源