CIM_LogicalFile 類別的 ChangeSecurityPermissions 方法
ChangeSecurityPermissions方法會變更物件路徑中所指定邏輯檔案的安全性許可權。 如果邏輯檔案是目錄， 則 ChangeSecurityPermissions 會以遞迴方式採取行動，變更目錄包含之所有檔案和子目錄的安全性許可權。
重要
DMTF (分散式管理工作組) CIM (Common Information Model) 類別是 WMI 類別建置所在的父類別。 WMI 目前僅支援 CIM 2.x 版本架構。
本主題使用 Managed 物件格式 (MOF) 語法。 如需使用此方法的詳細資訊，請參閱 呼叫 方法。
語法
uint32 ChangeSecurityPermissions(
[in] Win32_SecurityDescriptor SecurityDescriptor,
[in] uint32 Option
);
參數
-
SecurityDescriptor [in]
-
指定安全性資訊。
注意
SECURITY_DESCRIPTOR授與無限制存取權的ACL (ACL) Null存取控制清單。
-
選項 [in]
-
要修改的安全性許可權。 例如，若要變更擁有者和 DACL 安全性，請使用：
Option = 1 + 4或
Option = CHANGE_OWNER_SECURITY_INFORMATION | CHANGE_DACL_SECURITY_INFORMATION -
Change_Owner_Security_Information (1)
-
變更邏輯檔案的擁有者。
-
Change_Group_Security_Information (2)
-
變更邏輯檔案的群組。
-
Change_Dacl_Security_Information (4)
-
變更邏輯檔案的 ACL。
-
Change_Sacl_Security_Information (8)
-
變更邏輯檔案的系統 ACL。
傳回值
傳回成功時為 0 的值，以及指出錯誤的任何其他數位。
-
「成功」
-
0
成功。
-
拒絕存取
-
2
拒絕存取。
-
未指定的失敗
-
8
未指定的失敗。
-
不正確物件
-
9
不正確物件。
-
物件已經存在
-
10
物件已存在。
-
檔案系統不是 NTFS
-
11
檔案系統不是 NTFS。
-
平臺不是 NT/Windows 2000
-
12
平臺不是 Windows。
-
磁片磁碟機不相同
-
13
磁片磁碟機不相同。
-
目錄非空白
-
14
目錄未清空。
-
共用違規
-
15
共用違規。
-
不正確起始檔案
-
16
不正確起始檔案。
-
未保留的許可權
-
17
未保留的許可權。
-
參數不正確
-
21
無效的參數。
備註
WMI 目前未實作這個方法。 若要使用此方法，您必須在自己的提供者中實作它。
本檔衍生自 DMTF 所發佈的 CIM 類別描述。 Microsoft 可能已變更更正次要錯誤、符合 Microsoft SDK 檔標準，或提供詳細資訊。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows Vista |
| 最低支援的伺服器 |
Windows Server 2008 |
| 命名空間 |
Root\CIMV2 |
| MOF |
|
| DLL |
|