CIM_LogicalFile 類別的 TakeOwnerShipEx 方法

  • 發行項

TakeOwnerShipEx方法會取得物件路徑中指定的邏輯檔案擁有權。 這個方法是 TakeOwnerShip 方法的擴充版本。 如果邏輯檔案是目錄，則此方法會以遞迴方式運作，並取得目錄包含的所有檔案和子目錄擁有權。

重要

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

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

語法

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

參數

StopFileName [out]

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

StartFileName [in， optional]

字串，將子檔案命名為 (或目錄) 做為方法的起點。 一般而言，此參數是 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
CIMWin32.mof
DLL
CIMWin32.dll

另請參閱

CIM_LogicalFile

CIM_LogicalFile