共用方式為


重新命名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
CIMWin32.mof
DLL
CIMWin32.dll

另請參閱

CIM_DeviceFile

CIM_DeviceFile