The Rename WMI class method renames the codec file 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 topic uses Managed Object Format (MOF) syntax. For more information about using this method see Calling a Method.
Syntax
uint32 Rename(
string FileName
);
Parameters
FileName
Fully qualified new name of the file (or directory). Example: c:\temp\newfile.txt.
Return value
Returns an integer value of 0 (zero) if the file was successfully renamed, and any other number to indicate an error.
0
The request was successful.
2
Access was denied.
8
An unspecified failure occurred.
9
The name specified was not valid.
10
The object specified already exists.
11
The file system is not NTFS.
12
The platform is not Windows.
13
The drive is not the same.
14
The directory is not empty.
15
There has been a sharing violation.
16
The start file specified was not valid.
17
A privilege required for the operation is not held.
21
A parameter specified is not valid.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista |
| Minimum supported server | Windows Server 2008 |
| Namespace | Root\CIMV2 |
| MOF | CIMWin32.mof |
| DLL | CIMWin32.dll |
See also
Source: Microsoft Learn / Windows Win32 documentation by Microsoft and contributors. Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.
