重新命名CIM_DeviceFile類別的方法
Rename方法會將裝置檔案重新命名為物件路徑中指定的 (或目錄) 。 如果目的地位於另一個磁片磁碟機或覆寫現有的邏輯檔案，則不支援重新命名。 這個方法繼承自 CIM_LogicalFile。
重要
DMTF (分散式管理工作組) CIM (Common Information Model) 類別是 WMI 類別建置所在的父類別。 WMI 目前僅支援 CIM 2.x 版本架構。
本主題使用 Managed 物件格式 (MOF) 語法。 如需使用此方法的詳細資訊，請參閱 呼叫方法。
語法
uint32 Rename(
[in] string FileName
);
參數
-
FileName [in]
-
檔案的完整新名稱 (或目錄) 。
範例：「c:\temp\newfile.txt」
傳回值
傳回值 0 (零) 成功，以及任何其他數位表示錯誤。
-
0
-
成功。
-
2
-
拒絕存取。
-
8
-
未指定的失敗。
-
9
-
不正確物件。
-
10
-
物件已存在。
-
11
-
檔案系統不是 NTFS。
-
12
-
平臺不是 Windows。
-
13
-
磁片磁碟機不相同。
-
14
-
目錄未清空。
-
15
-
共用違規。
-
16
-
不正確起始檔案。
-
17
-
未保留的許可權。
-
21
-
無效的參數。
備註
WMI 目前未實作這個方法。 若要使用此方法，您必須在自己的提供者中實作它。
本檔衍生自 DMTF 所發佈的 CIM 類別描述。 Microsoft 可能已變更更正次要錯誤、符合 Microsoft SDK 檔標準，或提供詳細資訊。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows Vista |
| 最低支援的伺服器 |
Windows Server 2008 |
| 命名空間 |
Root\CIMV2 |
| MOF |
|
| DLL |
|