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

另請參閱

Win32_DCOMApplicationSetting

許可權常數

WMI 安全性描述元物件

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