Win32_CodecFile 類別的 ChangeSecurityPermissionsEx 方法
ChangeSecurityPermissionsExWMI 類別方法會變更物件路徑中指定的編解碼器檔案的安全性許可權， (此方法是ChangeSecurityPermissions方法) 的擴充版本。 如果邏輯檔案是目錄，則此方法會遞迴，並變更目錄包含之所有檔案和子目錄的安全性許可權。
本主題使用 Managed 物件格式 (MOF) 語法。 如需使用此方法的詳細資訊，請參閱 呼叫方法。
語法
uint32 ChangeSecurityPermissionsEx(
[in] Win32_SecurityDescriptor SecurityDescriptor,
[in] uint32 Option,
[out] string StopFileName,
[in, optional] string StartFileName,
[in, optional] boolean Recursive
);
參數
-
SecurityDescriptor [in]
-
解析為 Win32_SecurityDescriptor實例的運算式。 此描述項包含 Win32_CodecFile實例的新安全性許可權。
-
選項 [in]
-
要修改的實際安全性許可權。 例如，若要變更 DACL) 安全性 (擁有者和任意存取控制清單，請使用下列專案：
Option = 1 + 4-或-
Option = CHANGE_OWNER_SECURITY_INFORMATION | CHANGE_DACL_SECURITY_INFORMATION -
CHANGE_OWNER_SECURITY_INFORMATION (1 (0x1) )
-
變更邏輯檔案的擁有者。
-
CHANGE_GROUP_SECURITY_INFORMATION (2 (0x2) )
-
變更邏輯檔案的群組。
-
CHANGE_DACL_SECURITY_INFORMATION (4 (0x4) )
-
在邏輯檔案的 DACL) (變更任意存取控制清單。
-
CHANGE_SACL_SECURITY_INFORMATION (8 (0x8) )
-
變更邏輯檔案 (SACL) 的系統存取控制清單。
StopFileName [out]
ChangeSecurityPermissionsEx方法失敗的檔案或目錄名稱。 此方法成功時，這個參數為 null。
StartFileName [in， optional]
將子檔案或目錄命名為 ChangeSecurityPermissionsEx的起點。 一般而言， StartFileName 參數是 StopFileName 參數，指定先前方法呼叫發生錯誤的檔案或目錄。 如果此參數為 Null，則會在 ExecMethod 呼叫中指定的檔案或目錄上執行作業。
遞迴 [in， 選擇性]
如果 為 true，則會以遞迴方式將擁有權變更套用至 CIM_LogicalFile 實例所指定目錄中的檔案和目錄。 如果是檔案實例，則會忽略 遞迴 輸入參數。
傳回值
如果變更許可權，則傳回值為 0 (零) ，並傳回不同的數位來表示錯誤。
-
「成功」
-
0
要求成功。
-
拒絕存取
-
2
存取遭到拒絕。
-
未指定的失敗
-
8
發生未指定的失敗。
-
不正確物件
-
9
指定的名稱無效。
-
物件已經存在
-
10
指定的物件已存在。
-
檔案系統不是 NTFS
-
11
檔案系統不是 NTFS 檔案系統。
-
平臺不是 NT/Windows 2000
-
12
平臺不會Windows NT或 Windows 2000。
-
磁片磁碟機不同
-
13
磁片磁碟機不相同。
-
目錄非空白
-
14
目錄不是空的。
-
共用違規
-
15
共用違規。
-
不正確啟動檔案
-
16
指定的啟動檔案無效。
-
未保留的許可權
-
17
不會保留作業所需的許可權。
-
參數不正確
-
21
指定的參數無效。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows Vista |
| 最低支援的伺服器 |
Windows Server 2008 |
| 命名空間 |
Root\CIMV2 |
| MOF |
|
| DLL |
|