Rename method of the Win32_PageFile Class
Applies to: desktop apps only
The Rename WMI class method renames the paging 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( [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 |
|---|---|
|
The request was successful. |
|
Access was denied. |
|
An unspecified failure occurred. |
|
The name specified was not valid. |
|
The object specified already exists. |
|
The file system is not NTFS. |
|
The platform is not Windows 2000 or Windows NT. |
|
The drive is not the same. |
|
The directory is not empty. |
|
There has been a sharing violation. |
|
The start file specified was not valid. |
|
A privilege required for the operation is not held. |
|
A parameter specified is not valid. |
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 |
|---|---|
|
Minimum supported server | Windows 2000 Server |
|
Namespace |
\root\CIMV2 |
|
MOF |
|
|
DLL |
|
See also
Send comments about this topic to Microsoft
Build date: 3/9/2012