CIM_Directory 類別的 TakeOwnerShipEx 方法
TakeOwnerShipEx方法會取得物件路徑中指定的邏輯目錄專案檔案擁有權。 此方法是 TakeOwnerShip 方法的擴充版本，繼承自 CIM_LogicalFile。 如果邏輯檔案是目錄，則此方法會以遞迴方式運作，並取得目錄包含之所有檔案和子目錄的擁有權。
重要
DMTF (分散式管理工作組) CIM (Common Information Model) 類別是 WMI 類別建置所在的父類別。 WMI 目前僅支援 CIM 2.x 版本架構。
本主題使用 Managed 物件格式 (MOF) 語法。 如需使用此方法的詳細資訊，請參閱 呼叫 方法。
語法
uint32 TakeOwnerShipEx(
[out] string REF StopFileName,
[in] string StartFileName,
[in] boolean Recursive
);
參數
-
StopFileName [out]
-
字串，表示方法失敗之檔案的名稱 (或目錄) 。 如果方法成功，此參數為 null。
-
StartFileName [in]
-
字串，表示要作為此方法起點的子檔案 (或目錄) 。 一般而言，此參數是 StopFileName 參數，指定先前方法呼叫發生錯誤的檔案或目錄。 如果此參數為 null，則會在 ExecMethod 呼叫中指定的檔案上執行作業 (或目錄) 。
-
遞迴 [in]
-
如果 為 True，此方法會以遞迴方式套用至 CIM_Directory 實例所指定目錄中的檔案和目錄。 如果是檔案實例，則會忽略此參數。
傳回值
傳回成功時為 0 的值，以及指出錯誤的任何其他數位。
-
0
成功。
-
2
拒絕存取。
-
8
未指定的失敗。
-
9
不正確物件。
-
10
物件已存在。
-
11
檔案系統不是 NTFS。
-
12
平臺不是 Windows。
-
13
磁片磁碟機不相同。
-
14
目錄未清空。
-
15
共用違規。
-
16
不正確起始檔案。
-
17
未保留的許可權。
-
21
無效的參數。
備註
WMI 目前未實作這個方法。 若要使用此方法，您必須在自己的提供者中實作它。
本檔衍生自 DMTF 所發佈的 CIM 類別描述。 Microsoft 可能已變更更正次要錯誤、符合 Microsoft SDK 檔標準，或提供詳細資訊。
範例
下列 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 |
| 命名空間 |
Root\CIMV2 |
| MOF |
|
| DLL |
|