共用方式為


Win32_DCOMApplicationSetting 類別的 SetAccessSecurityDescriptor 方法

SetAccessSecurityDescriptor方法會使用由 Win32_SecurityDescriptor類別實例定義的新安全性描述元,更新 DCOM 應用程式的存取安全性描述元。 此安全性描述項可控制允許存取應用程式的人員。 執行呼叫此方法之腳本或應用程式的帳戶必須具有 SeSecurityPrivilegeSeRestorePrivilege 許可權。 如需詳細資訊,請參閱 變更安全性物件上的存取安全性

語法

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
CIMWin32.mof
DLL
CIMWin32.dll

另請參閱

Win32_DCOMApplicationSetting

許可權常數

WMI 安全性描述元物件

變更安全性實體物件的存取安全性