Win32_DCOMApplicationSetting 類別的 SetLaunchSecurityDescriptor 方法
SetLaunchSecurityDescriptor方法會以Win32_SecurityDescriptor類別實例所定義的新安全性描述元,更新 DCOM 應用程式的啟動安全性描述元。 此安全性描述項可控制允許啟動應用程式的人員。 執行呼叫此方法之腳本或應用程式的帳戶必須具有 SeSecurityPrivilege 和 SeRestorePrivilege 許可權。 如需詳細資訊,請參閱 變更安全性實體物件的存取安全性。
語法
uint32 SetLaunchSecurityDescriptor(
[in] Win32_SecurityDescriptor Descriptor
);
參數
-
描述元 [in]
-
要設定的安全性描述項,控制誰可以啟動 DCOM 應用程式。
傳回值
傳回下列清單中所列的其中一個值,或傳回不同的值來表示錯誤。 如需詳細資訊,請參閱 WMI 傳回碼 或 WbemErrorEnum。
-
「成功」
-
0
成功完成。
-
2
-
使用者無法存取要求的資訊。
-
8
-
未知的失敗。
-
9
-
使用者沒有足夠的許可權可執行 方法。
-
21
-
方法呼叫中指定的參數無效。
-
其他
-
1 4294967295
備註
Win32_SecurityDescriptor實例代表SECURITY_DESCRIPTOR_CONTROL資料類型,並包含 DACL) (DACL 的任意存取控制清單,以及 SACL) 的系統存取控制 (清單。 如需詳細資訊,請參閱存取控制清單。
如果在取得安全性描述元時未授與或啟用 SeSecurityPrivilege ,則只會在傳回的安全性描述元中傳回 DACL。 如需詳細資訊,請參閱 許可權常數 和執行 特殊許可權作業。
呼叫此方法時,您可以在 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 |
|