Win32_Directory 類別的 Copy 方法
複製WMI 類別方法會將物件路徑中指定的邏輯目錄項目檔案或目錄複製到輸入參數所指定的位置。 如果需要覆寫現有的邏輯檔案,則不支持複製。
本主題使用Managed物件格式 (MOF) 語法。 如需使用此方法的詳細資訊,請參閱 呼叫方法。
語法
uint32 Copy(
string FileName
);
參數
-
FileName
-
檔案複本的完整名稱(或目錄)。 範例:c:\temp\newdirectory
傳回值
如果已成功複製檔案,則傳回值 0 (零),以及任何其他數位,以指出錯誤。
-
0
-
要求成功。
-
2
-
拒絕存取。
-
8
-
發生未指定的失敗。
-
9
-
指定的名稱無效。
-
10
-
指定的物件已經存在。
-
11
-
檔案系統不是 NTFS。
-
12
-
平臺不是 Windows。
-
13
-
磁碟驅動器不相同。
-
14
-
目錄不是空的。
-
15
-
發生共享違規。
-
16
-
指定的啟動檔案無效。
-
17
-
作業所需的許可權不會保留。
-
21
-
指定的參數無效。
備註
資料夾通常需要從一個位置複製到另一個位置。 例如,您可以將資料夾從一部伺服器複製到另一部伺服器,以建立該資料夾的備份複本。 或者,您可能有需要複製到使用者工作站的templates資料夾,或應該複製到您所有 DNS 伺服器的腳本資料夾。
Win32_Directory Copy 方法可讓您將資料夾從一個位置複製到另一個位置,無論是在同一部電腦上(例如,將資料夾從磁碟驅動器 C 複製到磁碟驅動器 D)或遠端電腦上。 若要複製資料夾,您可以傳回要複製的資料夾實例,然後呼叫 Copy 方法,傳遞做為新資料夾複本之目標位置的參數。 例如,這一行程式代碼會將資料夾複製到磁碟驅動器 F 上的 Scripts 資料夾:
objFolder.Copy("F:\Scripts")
執行 Copy 方法時,WMI 不會覆寫現有的資料夾。 這表示如果目的地資料夾存在,複製作業就會失敗。 例如,假設您有一個名為 Scripts 的資料夾,並嘗試將該資料夾複製到名為 \\atl-fs-01\archive 的遠端共用。 如果名為 Scripts 的資料夾已存在於該共用上,複製作業就會失敗。
範例
下列程式代碼範例會使用 Copy 方法,將 C:\Scripts 資料夾複製到 D:\Archive。
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.Copy("D:\Archive")
Next
需求
需求 | 值 |
---|---|
最低支援的用戶端 |
Windows Vista |
最低支援的伺服器 |
Windows Server 2008 |
Namespace |
Root\CIMV2 |
MOF |
|
DLL |
|