This topic has not yet been rated - Rate this topic

Rename method of the CIM_DataFile class

The Rename method renames the logical file (or directory) that is specified in the object path. A rename is not supported if the destination is on another drive or if overwriting an existing logical file is required. This method is inherited from CIM_LogicalFile.

This topic uses Managed Object Format (MOF) syntax. For more information about using this method, see Calling a Method.

Syntax

mof


uint32 Rename(
  [in]  string FileName
);

Parameters

FileName [in]

Fully qualified new name of the file (or directory).

Example: "c:\temp\newfile.txt"

Return value

Return code	Description
0	Success.
2	Access denied.
8	Unspecified failure.
9	Invalid object.
10	Object already exists.
11	File system not NTFS.
12	Platform not Windows NT or Windows 2000.
13	Drive not the same.
14	Directory not empty.
15	Sharing violation.
16	Invalid start file.
17	Privilege not held.
21	Invalid parameter.

Remarks

The Rename method in CIM_DataFile is implemented by WMI.

This documentation is derived from the CIM class descriptions published by the DMTF. Microsoft may have made changes to correct minor errors, conform to Microsoft SDK documentation standards, or provide more information.

Examples

For script code examples, see WMI Tasks for Scripts and Applications and the TechNet ScriptCenter Script Repository.

For C++ code examples, see WMI C++ Application Examples.

Requirements

Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Namespace	\root\CIMV2
MOF	Cimwin32.mof
DLL	Cimwin32.dll

Community Additions

ADD