Win32_BaseService 類別的 UserControlService 方法

WMI 類別方法會嘗試將使用者定義控制項程式碼傳送至服務。

本主題使用 Managed 物件格式 (MOF) 語法。 如需使用此方法的詳細資訊，請參閱 呼叫方法。

語法

uint32 UserControlService(
  [in] uint8 ControlCode
);

參數

ControlCode [in]

值，指定服務的控制項命令。 例如，控制項命令是「暫停」或「繼續」命令。 此值可以是預先定義的程式碼，或是服務所定義的值和動作。 以下是預先定義的控制程式代碼：

SERVICE_CONTROL_CONTINUE

通知暫停的服務繼續。

SERVICE_CONTROL_INTERROGATE

通知服務向服務控制管理員報告目前的狀態資訊。

SERVICE_CONTROL_NETBINDADD

通知網路服務有新的元件可供系結。

SERVICE_CONTROL_NETBINDDISABLE

通知網路服務，其中一個系結已停用。

SERVICE_CONTROL_NETBINDENABLE

通知網路服務已啟用已停用的系結。

SERVICE_CONTROL_NETBINDREMOVE

通知網路服務已移除系結的元件。

SERVICE_CONTROL_PARAMCHANGE

通知服務其啟動參數已變更。

SERVICE_CONTROL_PAUSE

通知服務暫停。

SERVICE_CONTROL_STOP

通知服務停止。

傳回值

傳回下列清單中所列的其中一個值，或傳回不同的值來表示錯誤。

「成功」

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

服務目前在系統中暫停。

其他

25 4294967295

規格需求

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

另請參閱

作業系統類別

Win32_BaseService