CIM_DeviceFile 類別的 CopyEx 方法

CopyEx方法會將邏輯裝置檔案 (或目錄) 複製到FileName參數所指定位置的物件路徑中指定的位置。如果需要覆寫現有的邏輯檔案，則不支援複製。這個方法是 Copy 方法的擴充版本。這個方法繼承自 CIM_LogicalFile。

重要

DMTF (Distributed Management Task Force) CIM (Common Information Model) 類別是 WMI 類別所建置的父類別。 WMI 目前僅支援 CIM 2.x 版本架構。

本主題使用 Managed 物件格式 (MOF) 語法。如需使用此方法的詳細資訊，請參閱呼叫方法。

語法

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

FileName [in]

目的地檔案的完整名稱 (或目錄) 。

範例：「c：\temp\newdirectory」

StopFileName [out]

字串，表示方法失敗的檔案名稱 (或目錄) 。如果方法成功，則此參數為 null 。

StartFileName [in]

字串，表示要作為此方法起點的子檔案 (或目錄) 。一般而言， StartFileName 參數是 StopFileName 參數，指定先前方法呼叫發生錯誤的檔案或目錄。如果此參數為 null，則會在 ExecMethod 呼叫中指定的檔案 (或目錄) 上執行作業。

遞迴 [in]

如果為 TRUE，方法也會以遞迴方式套用至 CIM_DeviceFile 實例所指定目錄中的檔案和目錄。如果是檔案實例，則會忽略此參數。

傳回值 0 (零) 成功，並傳回任何其他數位來表示錯誤。

成功。

拒絕存取。

未指定的失敗。

不正確物件。

物件已存在。

檔案系統不是 NTFS。

平臺不是 Windows。

磁片磁碟機不同。

目錄未清空。

共用違規。

不正確啟動檔案。

未保留許可權。

無效的參數。

WMI 目前未實作這個方法。若要使用此方法，您必須在自己的提供者中實作此方法。

本檔衍生自 DMTF 所發佈的 CIM 類別描述。 Microsoft 可能已變更更正次要錯誤、符合 Microsoft SDK 檔標準，或提供詳細資訊。