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

ChangeStartModeWMI 類別方法會修改Win32_Service的啟動模式。

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

語法

uint32 ChangeStartMode(
  [in] string StartMode = Auto Start
);

參數

StartMode [in]

Windows 基底服務的啟動模式。

開機啟動 （“開機”）

由作業系統載入器啟動的裝置驅動程式。 此值僅適用於驅動程序服務。

系統 （“系統 ”）

由作業系統初始化程式啟動的裝置驅動程式。 此值僅適用於驅動程序服務。

自動啟動 （「自動」

服務控制管理員在系統啟動期間自動啟動的服務。

需求開始 （「手動」）

當行程呼叫 StartService 方法時，服務控制管理員所要啟動的服務 。

Disabled （“Disabled”）

無法再啟動的服務。

傳回值

傳回下列清單中所列的其中一個值，或任何其他值，以指出錯誤。 如需其他錯誤碼，請參閱 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

服務目前在系統中暫停。

其他

25 4294967295

範例

下列變更服務 PowerShell 範例的 StartMode 會變更服務的啟動模式。

$wmi = get-wmiobject -class win32_service -namespace root\cimv2 -computername lisbon | 
where-object { $_.name -eq 'bits' } 
 
$rtn = $wmi.changestartmode("manual") 
if($rtn.returnvalue -eq 0) { "success" } 
ELSE 
  { " $($rtn.returnvalue) was reported" }

需求

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

另請參閱

作業系統類別

Win32_Service

WMI 工作：服務