Metode CopyEx dari kelas Win32_Directory

Artikel
06/12/2023

Metode kelas CopyExWMI menyalin file entri direktori logis atau direktori yang ditentukan dalam jalur objek ke lokasi yang ditentukan oleh parameter FileName . Metode ini adalah versi yang diperluas dari metode Salin . Salinan tidak didukung jika menimpa file logika yang ada diperlukan.

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

Sintaks

uint32 CopyEx(
  [in]           string  FileName,
  [out]          string  StopFileName,
  [in, optional] string  StartFileName,
  [in, optional] boolean Recursive
);

Parameter

FileName [in]

Nama file yang sepenuhnya memenuhi syarat (atau direktori). Contoh: c:\temp\newdirectory.

StopFileName [out]

Nama file atau direktori tempat metode CopyEx gagal. Parameter ini akan null jika metode berhasil.

StartFileName [in, opsional]

Menamai file atau direktori anak yang akan digunakan sebagai titik awal untuk CopyEx. 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, file dan direktori akan disalin secara rekursif dalam direktori yang ditentukan oleh instans CIM_LogicalFile .

Catatan

Untuk instans file, parameter input Rekursif diabaikan.

Mengembalikan nilai

Mengembalikan nilai 0 (nol) jika file berhasil disalin, dan angka lain 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: Ada pelanggaran berbagi.
16: File mulai yang ditentukan tidak valid.
17: Hak istimewa yang diperlukan untuk operasi tidak ditahan.
21: Parameter yang ditentukan tidak valid.

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

Lihat juga

Kelas Sistem Operasi
Win32_Directory

Bagikan melalui