Win32 目錄類別的 TakeOwnerShipEx 方法 _

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

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

語法

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

參數

StopFileName [擴展]

TakeOwnerShipEx 方法失敗之檔案或目錄的名稱。 如果方法成功,則此參數為 Null

StartFileName [在中,選擇性]

將子檔案或目錄命名為 TakeOwnerShipEx 的起點。 StartFileName 參數通常是 StopFileName 參數,可指定上一個方法呼叫發生錯誤的檔案或目錄。 如果這個參數是 Null,則會在 ExecMethod 呼叫中指定的檔案或目錄上執行作業。

如果使用 StartFileName ,則 遞迴 也必須設定為 true。

遞迴 [在中,選擇性]

為 True,則會將擁有權變更以遞迴方式套用至 CIM _ LogicalFile 實例所指定之目錄中的檔案和目錄。

注意

若為檔案實例,則會忽略 遞迴 輸入參數。

傳回值

在成功時傳回 0 (零) 的整數值,並傳回任何其他數位以表示錯誤。

0

要求成功。

2

存取遭到拒絕。

8

發生未指定的失敗。

9

指定的名稱無效。

10

指定的物件已經存在。

11

檔案系統不是 NTFS。

12

平臺不是 Windows。

13

磁片磁碟機不相同。

14

目錄不是空的。

15

發生共用違規。

16

指定的起始檔無效。

17

不會保留操作所需的許可權。

21

指定的參數無效。

範例

下列 Visual Basic 腳本程式碼會呼叫 TakeOwnerShipEx 方法來取得 C: temp 資料夾的擁有權 \ 。

strComputer = "." 
Set objWMIService = GetObject("winmgmts:\\" & strComputer & "\root\CIMV2") 
' Obtain the definition of the class.
Set objShare = objWMIService.Get("Win32_Directory")
' Obtain an InParameters object specific
' to the method.
Set objInParam = objShare.Methods_("TakeOwnerShipEx").inParameters.SpawnInstance_()

' Add the input parameters.
objInParam.Properties_.Item("Recursive") =  true

' Execute the method and obtain the return status.
' The OutParameters object in objOutParams
' is created by the provider.
Set objOutParams = objWMIService.ExecMethod("Win32_Directory.Name='C:\Temp'", "TakeOwnerShipEx", objInParam)
wscript.echo objOutParams.ReturnValue

規格需求

需求
最低支援的用戶端
Windows Vista
最低支援的伺服器
Windows Server 2008
命名空間
根 \ CIMV2
MOF
CIMWin32 mof
DLL
CIMWin32.dll

另請參閱

作業系統類別

Win32 _ 目錄