重新命名CIM_LogicalFile類別的方法

Rename方法會將邏輯檔案重新命名為物件路徑中指定的 (或目錄) 。 如果目的地位於另一個磁片磁碟機上，或需要覆寫現有的邏輯檔案，則不支援重新命名。

重要

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

物件已存在。

檔案系統不是 NTFS

11

檔案系統不是 NTFS。

平臺不是 NT/Windows 2000

12

平臺不是 Windows。

磁片磁碟機不相同

13

磁片磁碟機不相同。

目錄非空白

14

目錄未清空。

共用違規

15

共用違規。

不正確起始檔案

16

不正確起始檔案。

未保留的許可權

17

未保留的許可權。

參數不正確

21

無效的參數。

備註

WMI 目前未實作這個方法。 若要使用此方法，您必須在自己的提供者中實作它。

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

規格需求

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

另請參閱

CIM_LogicalFile

CIM_LogicalFile