Win32 目錄類別的 Copy 方法 _

複製 WMI 類別方法會將物件路徑中指定的邏輯目錄專案檔或目錄複寫到輸入參數所指定的位置。 如果需要覆寫現有的邏輯檔案,則不支援複製。

本主題使用受控物件格式 (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

指定的參數無效。

備註

資料夾通常需要從一個位置複製到另一個位置。 例如,您可以將資料夾從一部伺服器複製到另一部伺服器,以建立該資料夾的備份複本。 或者,您可能會有需要複製到使用者工作站的 [範本] 資料夾,或是應該複製到所有 DNS 伺服器的 [腳本] 資料夾。

Win32 _ 目錄複寫方法可讓您在同一部 (電腦上將資料夾從一個位置複製到另一個位置,例如,將資料夾從磁片磁碟機 C 複製到磁片磁碟機 D) 或在遠端電腦上。 若要複製資料夾,您可以傳回要複製之資料夾的實例,然後呼叫 Copy 方法,以參數的方式傳遞新資料夾複本的目標位置。 例如,這行程式碼會將資料夾複製到磁片磁碟機 F 上的 Scripts 資料夾:

objFolder.Copy("F:\Scripts")

執行複製方法時,WMI 不會覆寫現有的資料夾。 這表示,如果目的地資料夾存在,則複製作業會失敗。 例如,假設您有一個名為 Scripts 的資料夾,而且您嘗試將該資料夾複製到名為「 \ \ atl-fs-01 封存」的遠端共用 \ 。 如果該共用上已有名稱為 Scripts 的資料夾,複製作業會失敗。

範例

使用 WMI 複製資料夾中取得的下列程式碼範例會使用複製方法,將資料夾 C: \ 腳本複製到 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
命名空間
根 \ CIMV2
MOF
CIMWin32 mof
DLL
CIMWin32.dll

另請參閱

作業系統類別

Win32 _ 目錄