Mengganti nama metode kelas CIM_DataFile
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 jika 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\newfile.txt"
Menampilkan nilai
Mengembalikan nilai 0 pada keberhasilan, dan angka lainnya untuk menunjukkan kesalahan. Untuk kode kesalahan tambahan, lihat Konstanta Kesalahan WMI atau WbemErrorEnum. Untuk nilai HRESULT umum, lihat Kode Kesalahan Sistem.
-
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 Ganti Nama dalam CIM_DataFile diimplementasikan oleh WMI.
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 |
|