共用方式為

Win32_BaseService 類別

  • 發行項

Win32_BaseService抽象WMI 類別代表安裝在 Service Control Manager 維護之登錄資料庫中的可執行物件。 與服務相關聯的可執行檔可以透過開機程式或系統在開機時啟動。 它也可以由服務控制管理員視需要啟動。 任何不是由特定使用者所擁有的服務或進程，以及提供電腦系統所支援之某些功能的介面，都是這個類別的子系 (或成員) 。

範例：執行 Windows Server 的電腦系統上，動態主機組態通訊協定 (DHCP) 用戶端服務。

下列語法已經過受管理物件格式 (MOF) 程式碼簡化，並包含所有已繼承的屬性。 屬性會依字母順序列出，而非 MOF 順序。

語法

[SupportsCreate, CreateBy("Create"), SupportsDelete, DeleteBy("DeleteInstance"), Abstract, Provider("CIMWin32"), UUID("{8502C4C4-5FBB-11D2-AAC1-006008C78BC7}"), DisplayName("System Drivers and Services"), AMENDMENT]
class Win32_BaseService : CIM_Service
{
  boolean  AcceptPause;
  boolean  AcceptStop;
  string   Caption;
  string   CreationClassName;
  string   Description;
  boolean  DesktopInteract;
  string   DisplayName;
  string   ErrorControl;
  uint32   ExitCode;
  datetime InstallDate;
  string   Name;
  string   PathName;
  uint32   ServiceSpecificExitCode;
  string   ServiceType;
  boolean  Started;
  string   StartMode;
  string   StartName;
  string   State;
  string   Status;
  string   SystemCreationClassName;
  string   SystemName;
  uint32   TagId;
};

成員

Win32_BaseService類別具有下列類型的成員：

方法

Win32_BaseService類別具有這些方法。

方法 Description
改變 修改服務。
ChangeStartMode 修改服務的啟動模式。
建立 建立新的服務。
刪除 刪除現有的服務。
InterrogateService 要求服務將其狀態更新為服務管理員。
PauseService 嘗試將此服務置於暫停狀態。
ResumeService 嘗試將此服務置於繼續狀態。
StartService 嘗試將服務置於其啟動狀態。
StopService 將服務置於已停止狀態的類別方法。
UserControlService 嘗試將使用者定義控制項程式碼傳送至服務。

屬性

Win32_BaseService類別具有這些屬性。

AcceptPause

資料類型： 布林值

存取類型：唯讀

限定詞： MappingStrings (「Win32API|服務結構|SERVICE_STATUS|dwControlsAccepted|SERVICE_ACCEPT_PAUSE_CONTINUE「) ， DisplayName (「服務接受暫停」)

服務可以暫停。

AcceptStop

資料類型： 布林值

存取類型：唯讀

限定詞： MappingStrings (「Win32API|服務結構|SERVICE_STATUS|dwControlsAccepted|SERVICE_ACCEPT_STOP「) ， DisplayName (」Service Accepts Stop「)

服務可以停止。

標題

資料類型： 字串

存取類型：唯讀

限定詞： MaxLen (64) 、 DisplayName (「Caption」)

物件的簡短描述。

此屬性繼承自 CIM_ManagedSystemElement。

CreationClassName

資料類型： 字串

存取類型：唯讀

限定詞： CIM_Key、 DisplayName (「類別名稱」)

要出現在實例建立時所使用之繼承鏈結中之第一個具體類別的名稱。 與 類別的其他索引鍵屬性搭配使用時，屬性可讓這個類別及其子類別的所有實例唯一識別。

此屬性繼承自 CIM_Service。

說明

資料類型： 字串

存取類型：唯讀

限定詞： DisplayName (「Description」)

物件的描述。

此屬性繼承自 CIM_ManagedSystemElement。

DesktopInteract

資料類型： 布林值

存取類型：唯讀

限定詞： MappingStrings (「Win32API|服務結構|QUERY_SERVICE_CONFIG|dwServiceType|SERVICE_INTERACTIVE_PROCESS「) ， DisplayName (」與桌面互動「)

服務可以建立或與桌面上的視窗通訊。

DisplayName

資料類型： 字串

存取類型：唯讀

限定詞： MappingStrings (「Win32API|服務結構|QUERY_SERVICE_CONFIG|lpDisplayName「) ， DisplayName (」顯示名稱「)

服務的顯示名稱。 這個字串的最大長度為 256 個字元。 名稱會在服務控制管理員中保留大小寫。 DisplayName的比較一律不區分大小寫。

條件約束：接受與 Name 屬性相同的值。

範例：「Atdisk」

ErrorControl

資料類型： 字串

存取類型：唯讀

限定詞： MappingStrings (「Win32API|服務結構|QUERY_SERVICE_CONFIG|dwErrorControl「) ， DisplayName (「啟動失敗嚴重性」)

錯誤的嚴重性。 服務無法啟動。 如果發生失敗，此值表示啟動程式所採取的動作。 電腦系統會記錄所有錯誤。

忽略 (「Ignore」)

不通知使用者。

標準 (「Normal」)

通知使用者。

嚴重 (「嚴重」)

系統以最後一個已知良好的組態重新開機。

重大 (「重大」)

系統嘗試以正確的組態重新啟動。

未知 (「未知」)

未指定所採取的動作。

ExitCode

資料類型： uint32

存取類型：唯讀

限定詞： MappingStrings (「Win32API|服務結構|SERVICE_STATUS|dwWin32ExitCode「) ， DisplayName (」Exit Code「)

定義啟動或停止服務時遇到的任何問題。 當錯誤對於此類別所代表的服務而言是唯一時，此屬性會設定為 [ERROR_SERVICE_SPECIFIC_ERROR] \(1066)，此錯誤的相關資訊可見於 ServiceSpecificExitCode 屬性。 服務會在正常終止時，將此值設定為 NO_ERROR 。

InstallDate

資料類型： datetime

存取類型：唯讀

限定詞： MappingStrings (「MIF。DMTF|ComponentID|001.5「) ， DisplayName (」Install Date「)

已安裝 物件。 這個屬性不需要值來指出已安裝物件。

此屬性繼承自 CIM_ManagedSystemElement。

名稱

資料類型： 字串

存取類型：唯讀

限定詞： 金鑰

服務的唯一識別碼，可提供受管理之功能的指示。 在物件的 Description 屬性中會更詳細地描述這項功能。

此屬性繼承自 CIM_ManagedSystemElement。

PathName

資料類型： 字串

存取類型：唯讀

限定詞： MappingStrings (「Win32API|服務結構|QUERY_SERVICE_CONFIG|lpBinaryPathName「) ， DisplayName (」檔案名「)

實作服務之服務二進位檔的完整路徑。

範例：「\SystemRoot\System32\drivers\afd.sys」

ServiceSpecificExitCode

資料類型： uint32

存取類型：唯讀

限定詞： MappingStrings (「Win32API|服務結構|SERVICE_STATUS|dwServiceSpecificExitCode「) ， DisplayName (」伺服器特定結束代碼「)

服務特定的錯誤碼，指出服務正在啟動或停止時發生的錯誤。 結束代碼是由這個類別所代表的服務所定義。 只有在 ExitCode 屬性 值 ERROR_SERVICE_SPECIFIC_ERROR ( 1066) 時，才會設定此值。

ServiceType

資料類型： 字串

存取類型：唯讀

限定詞： MappingStrings (「Win32API|服務結構|QUERY_SERVICE_CONFIG|dwServiceType「) ， DisplayName (」Service Type「)

提供給呼叫進程的服務。

核心驅動程式 (「核心驅動程式」)

檔案系統驅動程式 (「檔案系統驅動程式」)

配接器 (「Adapter」)

辨識器驅動程式 (「辨識器驅動程式」)

自有進程 (「擁有進程」)

共用進程 (「共用進程」)

互動式進程 (「互動式進程」)

Started

資料類型： 布林值

存取類型：唯讀

限定詞： DisplayName (「Started」)

服務已啟動。

此屬性繼承自 CIM_Service。

StartMode

資料類型： 字串

存取類型：唯讀

限定詞： 覆寫 (「StartMode」) 、 DisplayName (「開始模式」)

Windows 基底服務的啟動模式。

此屬性繼承自 CIM_Service。

開機 (「開機 」)

作業系統載入器啟動的裝置驅動程式 (僅適用于驅動程式服務) 。

系統 (「System」)

作業系統初始化程式啟動的裝置驅動程式。 這個值只適用於驅動程式服務。

自動 (「自動」)

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

手動 (「Manual」)

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

已停用 (「已停用」)

無法再啟動的服務。

StartName

資料類型： 字串

存取類型：唯讀

限定詞： MappingStrings (「Win32API|服務結構|QUERY_SERVICE_CONFIG|lpServiceStartName「) ， DisplayName (」Starting Account Name「)

服務執行所在的帳戶名稱。 視服務類型而定，帳戶名稱的格式可能是 「DomainName\Username」 或 UPN 格式 (Username@DomainName) 。 當服務進程執行時，將會使用這兩種形式之一來記錄。 如果帳戶屬於內建網域，可以指定 「.\Username」。 如果指定 Null ，服務將會以 LocalSystem 帳戶登入。 針對核心或系統層級驅動程式， StartName 包含驅動程式物件名稱 (，也就是 \FileSystem\Rdr 或 \Driver\Xns) 輸入與輸出 (I/O) 系統用來載入設備磁碟機。 此外，如果指定 Null ，驅動程式會根據服務名稱，以 I/O 系統所建立的預設物件名稱執行。 範例：「DWDOM\管理員」。

State

資料類型： 字串

存取類型：讀取/寫入

限定詞： MappingStrings (「Win32API|服務結構|SERVICE_STATUS|dwCurrentState 「) ， DisplayName (」State「)

基底服務的目前狀態。

已停止 (「已停止」)

啟動擱 置 (「開始擱置中」)

停止擱 置 (「停止暫止」)

執行 (「執行中」)

繼續暫止 (「繼續暫止」)

暫停暫止 (「暫停暫止」)

暫停 (「Paused」)

未知 (「未知」)

Windows Server 2008 和 Windows Vista： 此屬性是唯讀的。

狀態

資料類型： 字串

存取類型：唯讀

限定詞： MaxLen (10) 、 DisplayName (「Status」)

物件的目前狀態。 您可以定義各種操作和非操作狀態。 作業狀態包括：「確定」、「降級」和「預先失敗」 (啟用智慧型硬碟等元素，可能會正常運作，但預測近期的失敗) 。 非操作狀態包括：「Error」、「Starting」、「Stopping」 和 「Service」。 後者的「服務」可能會在磁片的鏡像重新儲存期間套用、重載使用者權限清單或其他系統管理工作。 並非所有這類工作都已上線，但 Managed 元素既不是「確定」，也不是在其他其中一種狀態中。

此屬性繼承自 CIM_ManagedSystemElement。

包括下列值：

確定 (「確定」)

錯誤 (「錯誤」)

降級 (「降級」)

未知 (「未知」)

Pred Fail (「預先失敗」)

starting (「Starting」)

停止 (「停止」)

服務 (「Service」)

壓力 (「壓力」)

NonRecover (「NonRecover」)

無連絡人 (「無連絡人」)

Lost Comm (「Lost Comm」)

SystemCreationClassName

資料類型： 字串

存取類型：唯讀

限定詞： 傳播 (「CIM_System。CreationClassName「 ) 、CIM_Key、 DisplayName (」System Class Name「)

裝載此服務的系統類型名稱。

此屬性繼承自 CIM_Service。

SystemName

資料類型： 字串

存取類型：唯讀

限定詞： 傳播 (「CIM_System。Name「) ， CIM_Key， DisplayName (」System Name「)

裝載此服務的系統名稱。

此屬性繼承自 CIM_Service。

TagId

資料類型： uint32

存取類型：唯讀

限定詞： MappingStrings (「Win32API|服務結構|QUERY_SERVICE_CONFIG|dwTagId「) ， DisplayName (」標記識別項「)

群組中此服務的唯一標籤值。 值 0 (零) 表示服務尚未指派標記。 標籤可用來在載入順序群組內排序服務star tup，方法是在登錄中指定位於：HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\GroupOrderList的標籤順序向量。 標記只會針對具有開機模式或系統啟動模式的核心驅動程式和檔案系統驅動程式啟動類型服務進行評估。

備註

Win32_BaseService類別衍生自CIM_Service。

規格需求

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

另請參閱

CIM_Service

作業系統類別