Mengganti nama metode kelas CIM_Directory
Metode Ganti Nama mengganti nama file logis (atau direktori) yang ditentukan dalam jalur objek. Penggantian nama tidak didukung jika tujuan berada di drive lain atau menimpa file logika yang ada diperlukan.
Metode ini diwarisi dari CIM_LogicalFile.
Penting
Kelas CIM (Model Informasi Umum) DMTF (Distributed Management Task Force) adalah kelas induk tempat kelas WMI dibangun. WMI saat ini hanya mendukung skema versi CIM 2.x.
Topik ini menggunakan sintaks Managed Object Format (MOF). Untuk informasi selengkapnya tentang menggunakan metode ini, lihat Memanggil Metode.
Sintaks
uint32 Rename(
[in] string FileName
);
Parameter
-
FileName [in]
-
Nama baru file yang sepenuhnya memenuhi syarat (atau direktori).
Contoh: "c:\temp\newname.txt"
Menampilkan nilai
Mengembalikan nilai 0 (nol) pada keberhasilan, dan angka lainnya untuk menunjukkan kesalahan.
-
0
-
Berhasil.
-
2
-
Akses ditolak.
-
8
-
Kegagalan yang tidak ditentukan.
-
9
-
Objek tidak valid.
-
10
-
Objek sudah ada.
-
11
-
Sistem file bukan NTFS.
-
12
-
Platform bukan Windows.
-
13
-
Drive tidak sama.
-
14
-
Direktori tidak kosong.
-
15
-
Pelanggaran berbagi.
-
16
-
File mulai tidak valid.
-
17
-
Hak istimewa tidak ditahan.
-
21
-
Parameter tidak valid.
Keterangan
Metode ini saat ini tidak diimplementasikan oleh WMI. Untuk menggunakan metode ini, Anda harus menerapkannya di penyedia Anda sendiri.
Dokumentasi ini berasal dari deskripsi kelas CIM yang diterbitkan oleh DMTF. Microsoft mungkin telah membuat perubahan untuk memperbaiki kesalahan kecil, sesuai dengan standar dokumentasi Microsoft SDK, atau memberikan informasi selengkapnya.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung |
Windows Vista |
| Server minimum yang didukung |
Windows Server 2008 |
| Ruang nama |
Root\CIMV2 |
| MOF |
|
| DLL |
|