Win32_CodecFile 類別的 ChangeSecurityPermissions 方法
ChangeSecurityPermissionsWMI 類別方法會變更物件路徑中指定的邏輯編解碼器檔案的安全性許可權。 如果邏輯檔案是目錄， 則 ChangeSecurityPermissions 會遞迴，並變更目錄包含之所有檔案和子目錄的安全性許可權。 ChangeSecurityPermissions 會傳回整數值 0 (零，如果許可權已變更，則會傳回 0) ，以及指出錯誤的不同數位。
本主題使用 Managed 物件格式 (MOF) 語法。 如需使用此方法的詳細資訊，請參閱 呼叫方法。
語法
uint32 ChangeSecurityPermissions(
[in] Win32_SecurityDescriptor SecurityDescriptor,
[in] uint32 Option
);
參數
-
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) 的系統存取控制清單。
傳回值
如果變更許可權，則傳回值為 0 (零) ，並傳回不同的數位來表示錯誤。
-
「成功」
-
0
要求成功。
-
拒絕存取
-
2
存取遭到拒絕。
-
未指定的失敗
-
8
發生未指定的失敗。
-
不正確物件
-
9
指定的名稱無效。
-
物件已經存在
-
10
指定的物件已存在。
-
檔案系統不是 NTFS
-
11
檔案系統不是 NTFS 檔案系統。
-
平臺不是 NT/Windows 2000
-
12
平臺不是 Windows。
-
磁片磁碟機不同
-
13
磁片磁碟機不相同。
-
目錄非空白
-
14
目錄不是空的。
-
共用違規
-
15
共用違規。
-
不正確啟動檔案
-
16
指定的啟動檔案無效。
-
未保留的許可權
-
17
不會保留作業所需的許可權。
-
參數不正確
-
21
指定的參數無效。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows Vista |
| 最低支援的伺服器 |
Windows Server 2008 |
| 命名空間 |
Root\CIMV2 |
| MOF |
|
| DLL |
|