Win32_DCOMApplicationSetting 類別的 SetAccessSecurityDescriptor 方法
SetAccessSecurityDescriptor方法會使用由 Win32_SecurityDescriptor類別實例定義的新安全性描述元,更新 DCOM 應用程式的存取安全性描述元。 此安全性描述項可控制允許存取應用程式的人員。 執行呼叫此方法之腳本或應用程式的帳戶必須具有 SeSecurityPrivilege 和 SeRestorePrivilege 許可權。 如需詳細資訊,請參閱 變更安全性物件上的存取安全性。
語法
uint32 SetAccessSecurityDescriptor(
[in] Win32_SecurityDescriptor Descriptor
);
參數
-
描述元 [in]
-
要為 DCOM 應用程式設定的安全性描述元。
傳回值
傳回下列清單中所列的其中一個值,或不同的值來表示錯誤。 如需詳細資訊,請參閱 WMI 傳回碼 或 WbemErrorEnum。
-
「成功」
-
0
成功完成
-
2
-
使用者無法存取要求的資訊
-
8
-
未知失敗
-
9
-
使用者沒有足夠的許可權可執行 方法
-
21
-
方法呼叫中指定的參數無效
-
其他
-
1 4294967295
備註
Win32_SecurityDescriptor實例代表SECURITY_DESCRIPTOR_CONTROL資料類型,並包含 DACL ) 的任意存取控制 (清單,以及 (SACL) 的系統存取控制清單。 如需詳細資訊,請參閱存取控制清單。
如果在取得安全性描述元時未授與或啟用 SeSecurityPrivilege ,則只會在傳回的安全性描述元中傳回 DACL。 如需詳細資訊,請參閱 Privilege Constants 和 執行 Privileged Operations。
呼叫此方法時,您可以在 Win32_SecurityDescriptor 實例中更新 DACL 和 SACL,但您也可以只更新 DACL 或 SACL。
SECURITY_DESCRIPTOR_CONTROL中的下列值會判斷是否更新 DACL、SACL 或兩者。
SE_DACL_PRESENT
指出應更新 DACL。 如果未設定,則 WMI 會保留 DACL 的原始值。
SE_SACL_PRESENT
指出應該更新 SACL。 如果未設定,則 WMI 會保留 SACL 的原始值。 若要更新 SACL,帳戶必須啟用 SeSecurityPrivilege 許可權。 針對腳本,許可權名稱為 SeSecurityPrivilege。 如需詳細資訊,請參閱 Privilege Constants。
如果群組信任項和擁有者信任項屬性不是 Null,則會更新它們。 否則,WMI 會保留原始值。 如需詳細資訊,請參閱 WMI 安全性描述元物件。
當這個方法的呼叫中新的 SACL 為 Null 時,目標安全實體物件上的安全性描述元 SACL 會保持不變。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 |
Windows Vista |
最低支援的伺服器 |
Windows Server 2008 |
命名空間 |
Root\CIMV2 |
MOF |
|
DLL |
|