Metode TakeOwnerShipEx dari kelas Win32_Directory
Metode kelas TakeOwnerShipExWMI mendapatkan kepemilikan file entri direktori logis yang ditentukan di jalur objek. Metode ini adalah versi yang diperluas dari metode TakeOwnerShip . Jika file logis sebenarnya adalah direktori, maka metode ini bertindak secara rekursif, mengambil kepemilikan semua file dan subdirektori yang dikandung direktori.
Topik ini menggunakan sintaks Managed Object Format (MOF). Untuk informasi selengkapnya tentang menggunakan metode ini, lihat Memanggil Metode.
Sintaks
uint32 TakeOwnerShipEx(
[out] string StopFileName,
[in, optional] string StartFileName,
[in, optional] boolean Recursive
);
Parameter
-
StopFileName [out]
-
Nama file atau direktori tempat metode TakeOwnerShipEx gagal. Parameter ini adalah NULL jika metode berhasil.
-
StartFileName [dalam, opsional]
-
Menamai file atau direktori anak yang akan digunakan sebagai titik awal untuk TakeOwnerShipEx. Parameter StartFileName biasanya adalah parameter StopFileName yang menentukan file atau direktori tempat kesalahan terjadi dari panggilan metode sebelumnya. Jika parameter ini NULL, operasi dilakukan pada file atau direktori yang ditentukan dalam panggilan ExecMethod .
Jika StartFileName digunakan, Rekursif juga harus diatur ke true.
-
Rekursif [in, opsional]
-
Jika True, perubahan kepemilikan diterapkan secara rekursif ke file dan direktori dalam direktori yang ditentukan oleh instans CIM_LogicalFile .
Catatan
Untuk instans file, parameter input Rekursif diabaikan.
Mengembalikan nilai
Mengembalikan nilai bilangan bulat 0 (nol) pada keberhasilan, 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 awal yang ditentukan tidak valid.
-
17
-
Hak istimewa yang diperlukan untuk operasi tidak ditahan.
-
21
-
Parameter yang ditentukan tidak valid.
Contoh
Kode Visual Basic Script berikut memanggil metode TakeOwnerShipEx untuk mengambil kepemilikan folder C:\temp.
strComputer = "."
Set objWMIService = GetObject("winmgmts:\\" & strComputer & "\root\CIMV2")
' Obtain the definition of the class.
Set objShare = objWMIService.Get("Win32_Directory")
' Obtain an InParameters object specific
' to the method.
Set objInParam = objShare.Methods_("TakeOwnerShipEx").inParameters.SpawnInstance_()
' Add the input parameters.
objInParam.Properties_.Item("Recursive") = true
' Execute the method and obtain the return status.
' The OutParameters object in objOutParams
' is created by the provider.
Set objOutParams = objWMIService.ExecMethod("Win32_Directory.Name='C:\Temp'", "TakeOwnerShipEx", objInParam)
wscript.echo objOutParams.ReturnValue
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung |
Windows Vista |
| Server minimum yang didukung |
Windows Server 2008 |
| Ruang nama |
Root\CIMV2 |
| MOF |
|
| DLL |
|