Метод Rename класса CIM_Directory
Метод Rename переименовывает логический файл (или каталог), указанный в пути к объекту. Переименование не поддерживается, если назначение находится на другом диске или требуется перезапись существующего логического файла.
Этот метод наследуется от CIM_LogicalFile.
Важно!
Классы CIM (Common Information Model) DMTF (Distributed Management Task Force) являются родительскими классами, на основе которых строятся классы WMI. В настоящее время WMI поддерживает только схемы версии CIM 2.x.
В этом разделе используется синтаксис MOF. Дополнительные сведения об использовании этого метода см. в разделе Вызов метода .
Синтаксис
uint32 Rename(
[in] string FileName
);
Параметры
-
FileName [in]
-
Полное новое имя файла (или каталога).
Пример: "c:\temp\newname.txt"
Возвращаемое значение
Возвращает значение 0 (ноль) при успешном выполнении и любое другое число, указывающее на ошибку.
-
0
-
Успешно.
-
2
-
Доступ запрещен.
-
8
-
Неуказанным сбоем.
-
9
-
Недопустимый объект.
-
10
-
Объект уже существует.
-
11
-
Файловая система не NTFS.
-
12
-
Платформа, а не Windows.
-
13
-
Диск не тот же.
-
14
-
Каталог не пуст.
-
15
-
Нарушение правил общего доступа.
-
16
-
Недопустимый начальный файл.
-
17
-
Привилегия не удерживаема.
-
21
-
Недопустимый параметр.
Комментарии
В настоящее время этот метод не реализуется WMI. Чтобы использовать этот метод, необходимо реализовать его в собственном поставщике.
Эта документация является производным от описаний классов CIM, опубликованных DMTF. Возможно, корпорация Майкрософт внесла изменения для исправления незначительных ошибок, соответствия стандартам документации по Microsoft SDK или предоставления дополнительных сведений.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows Vista |
| Минимальная версия сервера |
Windows Server 2008 |
| Пространство имен |
Root\CIMV2 |
| MOF |
|
| DLL |
|