CIM_LogicalFile 類別的 CopyEx 方法
CopyEx方法會將邏輯檔案 (或目錄) 複製到FileName參數所指定的位置。 如果需要覆寫現有的邏輯檔案，則不支援複製。 這個方法是 Copy 方法的擴充版本。
重要
DMTF (Distributed Management Task Force) CIM (Common Information Model) 類別是 WMI 類別所建置的父類別。 WMI 目前僅支援 CIM 2.x 版本架構。
本主題使用 Managed 物件格式 (MOF) 語法。 如需使用此方法的詳細資訊，請參閱 呼叫方法。
語法
uint32 CopyEx(
[in] string FileName,
[out] string StopFileName,
[in, optional] string StartFileName,
[in, optional] boolean Recursive
);
參數
-
FileName [in]
-
目的地檔案的完整名稱 (或目錄) 。
範例：「c：\temp\newdirectory」
-
StopFileName [out]
-
字串，表示方法失敗的檔案名稱 (或目錄) 。 如果方法成功，則此參數為 null 。
-
StartFileName [in， optional]
-
將子檔案命名為 (或目錄) 做為此方法起點的字串。 一般而言， StartFileName 參數是 StopFileName 參數，指定先前方法呼叫發生錯誤的檔案 (或目錄) 。 如果此參數為 Null，則會在 ExecMethod 呼叫中指定的檔案或目錄上執行作業。
-
遞迴 [in， 選擇性]
-
如果為 TRUE，方法也會以遞迴方式套用至 CIM_LogicalFile 實例所指定目錄中的檔案和目錄。 如果是檔案實例，則會忽略此參數。
傳回值
傳回值 0 (零) 成功，並傳回任何其他數位來表示錯誤。
-
「成功」
-
0
成功。
-
拒絕存取
-
2
拒絕存取。
-
未指定的失敗
-
8
未指定的失敗。
-
不正確物件
-
9
不正確物件。
-
物件已經存在
-
10
物件已存在。
-
檔案系統不是 NTFS
-
11
檔案系統不是 NTFS。
-
平臺不是 NT/Windows 2000
-
12
平臺不是 Windows。
-
磁片磁碟機不同
-
13
磁片磁碟機不同。
-
目錄非空白
-
14
目錄未清空。
-
共用違規
-
15
共用違規。
-
不正確啟動檔案
-
16
不正確啟動檔案。
-
未保留的許可權
-
17
未保留許可權。
-
參數不正確
-
21
無效的參數。
備註
WMI 目前未實作這個方法。 若要使用此方法，您必須在自己的提供者中實作此方法。
本檔衍生自 DMTF 所發佈的 CIM 類別描述。 Microsoft 可能已變更更正次要錯誤、符合 Microsoft SDK 檔標準，或提供詳細資訊。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows Vista |
| 最低支援的伺服器 |
Windows Server 2008 |
| 命名空間 |
Root\CIMV2 |
| MOF |
|
| DLL |
|