Win32_Service 類別的 GetSecurityDescriptor 方法 （CIMWin32 WMI 提供者）

GetSecurityDescriptor 方法會傳回控制服務存取權的安全性描述項。 描述項會以 Win32_SecurityDescriptor 的 實例傳回。

語法

uint32 GetSecurityDescriptor(
  [out] Win32_SecurityDescriptor Descriptor
);

參數

描述元 [out]

與服務相關聯的安全性描述元。

傳回值

傳回下列清單中所列的其中一個值，或指出錯誤的不同值。 如需其他錯誤碼，請參閱 WMI 錯誤常數 或 WbemErrorEnum 。 如需一般 HRESULT 值，請參閱 系統錯誤碼 。

「成功」

0

已接受要求。

1

不支援此要求。

拒絕存取

2

使用者沒有必要的存取權。

3

無法停止服務，因為正在執行的其他服務相依于它。

4

要求的控制程式代碼無效，或服務無法接受。

5

要求的控制程式代碼無法傳送至服務，因為服務的狀態 （ Win32_BaseService 。 State 屬性） 等於 0、1 或 2。

6

服務尚未啟動。

7

服務未及時回應啟動要求。

未知的失敗

8

啟動服務時發生未知的失敗。

許可權遺失

9

找不到服務可執行檔的目錄路徑。

10

服務已在執行中。

11

要加入新服務的資料庫已鎖定。

12

此服務所依賴的相依性已從系統中移除。

13

服務找不到相依服務所需的服務。

14

服務已從系統停用。

15

服務沒有在系統上執行的正確驗證。

16

此服務正從系統中移除。

17

服務沒有執行執行緒。

18

服務啟動時會有迴圈相依性。

19

服務是以相同名稱執行。

20

服務名稱具有不正確字元。

不正確參數

21

不正確參數已傳遞至服務。

22

此服務執行的帳戶無效或缺少執行服務的許可權。

23

服務存在於系統可用的服務資料庫中。

24

服務目前在系統中暫停。

其他

22 4294967295

備註

Win32_SecurityDescriptor 實例代表 SECURITY_DESCRIPTOR_CONTROL 資料類型，並包含 任意存取控制清單 （DACL） 和 系統存取控制清單 （SACL）。 如需詳細資訊，請參閱 存取控制清單 。

如果在取得安全性描述元時未授與或啟用 SeSecurityPrivilege ，則只會在傳回的安全性描述元中傳回 DACL。 如需詳細資訊，請參閱 許可權常數 和執行 特殊許可權作業 。

範例

在 VBScript 中擷取安全性描述元時，請務必「安全性」並執行為管理員，如下列程式碼片段所示。 否則，您的程式碼可能會擲回許可權錯誤。

Set objWMIService = GetObject("winmgmts:" _
  & "{impersonationLevel=impersonate, (Security)}!\\" & strComputer & "\root\cimv2")

同樣地，在 VB.NET 中，請務必設定 「EnablePrivileges = True」，並將應用程式執行為管理員。

Scope = New ManagementScope([String].Format("\\{0}\root\CIMV2", ComputerName), Nothing)
Scope.Options.EnablePrivileges = True

需求

需求	值
最低支援的用戶端	Windows Vista
最低支援的伺服器	Windows Server 2008
Namespace	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

另請參閱

Win32_Service

Privilege 常數

WMI 安全性描述元物件

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

使用者帳戶控制和 WMI