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 |
|
| DLL |
|