Mengganti nama metode kelas Win32_Directory

Artikel
11/10/2023

Metode Ganti namakelas WMI mengganti nama file entri direktori yang ditentukan dalam jalur objek. Penggantian nama tidak didukung jika tujuan berada di drive lain atau jika menimpa file logis yang ada diperlukan.

Topik ini menggunakan sintaksIs Managed Object Format (MOF). Untuk informasi selengkapnya tentang menggunakan metode ini lihat Memanggil Metode.

Sintaks

uint32 Rename(
   string FileName
);

Parameter

FileName: Nama baru file yang sepenuhnya memenuhi syarat (atau direktori). Contoh: c:\temp\newfile.txt.

Nilai hasil

Mengembalikan nilai 0 (nol) jika file berhasil diganti namanya, dan angka lainnya untuk menunjukkan kesalahan.

0: Permintaan berhasil.
2: Akses ditolak.
8: Terjadi kegagalan yang tidak ditentukan.
9: Nama yang ditentukan tidak valid.
10: Objek yang ditentukan sudah ada.
11: Sistem file bukan NTFS.
12: Platform ini bukan Windows.
13: Drive tidak sama.
14: Direktori tidak kosong.
15: Telah terjadi pelanggaran berbagi.
16: File mulai yang ditentukan tidak valid.
17: Hak istimewa yang diperlukan untuk operasi tidak ditahan.
21: Parameter yang ditentukan tidak valid.

Keterangan

Untuk mengganti nama folder, pertama-tama ikat ke folder yang dimaksud lalu panggil metode Ganti Nama. Sebagai satu-satu parameter ke metode , berikan nama baru untuk folder sebagai nama jalur lengkap. Misalnya, jika folder di C:\Scripts\Logs\Backup akan diganti namanya menjadi C:\Scripts\Archive, Anda harus meneruskan C:\Scripts\Archive sebagai nama folder lengkap. Meneruskan hanya nama folder - Arsip - menghasilkan kesalahan jalur yang tidak valid.

Kelas Win32_Directory tidak menyediakan metode satu langkah untuk memindahkan folder. Sebagai gantinya, memindahkan folder umumnya melibatkan dua langkah:

1. Menyalin folder ke lokasi baru 2. Menghapus folder asli

Satu pengecualian untuk proses dua langkah ini melibatkan pemindahan folder ke lokasi baru pada drive yang sama. Misalnya, Anda ingin memindahkan C:\Temp ke C:\Scripts\Temporary Files\Archive. Selama lokasi saat ini dan lokasi baru berada di drive yang sama, Anda dapat memindahkan folder hanya dengan memanggil metode Ganti Nama dan melewati lokasi baru sebagai parameter metode. Pendekatan ini secara efektif memungkinkan Anda memindahkan folder dalam satu langkah. Namun, skrip gagal jika drive saat ini dan drive baru berbeda. Upaya untuk mengganti nama C:\Temp ke D:\Temp gagal dengan kesalahan "Drive tidak sama".

Contoh

Kode berikut menggunakan metode Ganti Nama untuk memindahkan folder C:\Scripts ke C:\Admins\Documents\Archive\VBScript.

strComputer = "." 
Set objWMIService = GetObject("winmgmts:" _ 
    & "{impersonationLevel=impersonate}!\\" & strComputer & "\root\cimv2") 
 
Set colFolders = objWMIService.ExecQuery _ 
    ("Select * from Win32_Directory where name = 'c:\\Scripts'") 
 
For Each objFolder in colFolders 
    errResults = objFolder.Rename("C:\Admins\Documents\Archive\VBScript") 
Next

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista
Server minimum yang didukung	Windows Server 2008
Ruang nama	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

Bagikan melalui