Win32_ShortcutFile 類別的 TakeOwnerShipEx 方法
TakeOwnerShipExWMI 類別方法會取得物件路徑中指定的邏輯快捷方式檔案擁有權。 此方法是 TakeOwnerShip 方法的擴充版本。 如果邏輯檔案實際上是目錄，則此方法會以遞迴方式運作，並取得目錄包含之所有檔案和子目錄的擁有權。
本主題使用 Managed 物件格式 (MOF) 語法。 如需使用此方法的詳細資訊，請參閱 呼叫 方法。
語法
uint32 TakeOwnerShipEx(
[out] string StopFileName,
[in, optional] string StartFileName,
[in, optional] boolean Recursive
);
參數
-
StopFileName [out]
-
TakeOwnerShipEx方法失敗的檔案或目錄名稱。 如果方法成功，這個參數將會是 Null 。
-
StartFileName [in， optional]
-
將子檔案或目錄命名為 TakeOwnerShipEx的起點。 StartFileName參數通常是StopFileName參數，指定先前方法呼叫發生錯誤的檔案或目錄。 如果此參數為 Null，作業會在 ExecMethod 呼叫中指定的檔案或目錄上執行。
-
遞迴 [in， 選擇性]
-
如果 為 true，則擁有權變更會以遞迴方式套用至 CIM_LogicalFile 實例所指定目錄中的檔案和目錄。
注意
對於檔案實例，會忽略 遞迴 參數。
傳回值
傳回值 0 (零) 成功，以及任何其他數位表示錯誤。
-
0
-
要求成功。
-
2
-
拒絕存取。
-
8
-
發生未指定的失敗。
-
9
-
指定的名稱無效。
-
10
-
指定的 物件已經存在。
-
11
-
檔案系統不是 NTFS。
-
12
-
平臺不是 Windows。
-
13
-
磁片磁碟機不相同。
-
14
-
目錄不是空的。
-
15
-
發生共用違規。
-
16
-
指定的開始檔案無效。
-
17
-
作業所需的許可權不會保留。
-
21
-
指定的參數無效。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows Vista |
| 最低支援的伺服器 |
Windows Server 2008 |
| 命名空間 |
Root\CIMV2 |
| MOF |
|
| DLL |
|