Win32_BaseService クラス

[アーティクル]
06/12/2023

Win32_BaseService抽象 WMI クラスは、Service Control Manager によって管理されるレジストリデータベースにインストールされている実行可能オブジェクトを表します。サービスに関連付けられている実行可能ファイルは、ブートプログラムまたはシステムによってブート時に開始できます。また、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 クラスには、これらのメソッドがあります。

メソッド	説明
変更	サービスを変更します。
ChangeStartMode	サービスの開始モードを変更します。
作成	新しいサービスを作成します。
削除	既存のサービスを削除します。
InterrogateService	サービスの状態をサービスマネージャーに更新するように要求します。
PauseService	サービスを一時停止状態にする動作を試行します。
ResumeService	サービスを再開状態にする動作を試行します。
StartService	サービスをスタートアップ状態にしようとします。
Stopservice	サービスを停止状態にするクラスメソッド。
UserControlService	ユーザー定義コントロールコードをサービスに送信しようとします。

プロパティ

Win32_BaseService クラスには、これらのプロパティがあります。

AcceptPause

データ型: boolean
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32API|サービス構造|SERVICE_STATUS|dwControlsAccepted|SERVICE_ACCEPT_PAUSE_CONTINUE") 、DisplayName ("Service Accepts Pause")

サービスは一時停止できます。

AcceptStop

データ型: boolean
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32API|サービス構造|SERVICE_STATUS|dwControlsAccepted|SERVICE_ACCEPT_STOP") 、DisplayName ("Service Accepts Stop")

サービスを停止できます。

Caption

データ型: string
アクセスの種類: 読み取り専用
修飾子: MaxLen (64)、 DisplayName ("Caption")

オブジェクトの簡単な説明。

このプロパティは 、CIM_ManagedSystemElementから継承されます。

CreationClassName

データ型: string
アクセスの種類: 読み取り専用
修飾子: CIM_Key、 DisplayName ("クラス名")

インスタンスの作成で使用される継承チェーンに表示される最初の具象クラスの名前。クラスの他のキープロパティと共に使用すると、プロパティを使用すると、このクラスとそのサブクラスのすべてのインスタンスを一意に識別できます。

このプロパティは、 CIM_Serviceから継承されます。

説明

データ型: string
アクセスの種類: 読み取り専用
修飾子: DisplayName ("Description")

オブジェクトの説明。

このプロパティは 、CIM_ManagedSystemElementから継承されます。

DesktopInteract

データ型: boolean
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32API|サービス構造|QUERY_SERVICE_CONFIG|dwServiceType|SERVICE_INTERACTIVE_PROCESS")、 DisplayName ("Interacts with Desktop")

サービスは、デスクトップ上のウィンドウを作成または通信できます。

DisplayName

データ型: string
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32API|サービス構造|QUERY_SERVICE_CONFIG|lpDisplayName"), DisplayName ("Display Name")

サービスの表示名。この文字列の長さは最大 256 文字です。名前は Service Control Manager で大文字と小文字が区別されます。 DisplayName の比較では、常に大文字と小文字が区別されません。

制約: Name プロパティと同じ値を受け入れます。

例: "Atdisk"

ErrorControl

データ型: string
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32API|サービス構造|QUERY_SERVICE_CONFIG|dwErrorControl"), DisplayName ("起動エラーの重大度")

エラーの重大度。サービスの開始に失敗します。値は、障害が発生した場合にスタートアッププログラムによって実行されるアクションを示します。すべてのエラーは、コンピューターシステムによって記録されます。

Ignore ("Ignore")

ユーザーへの通知が行われません。

Normal ("Normal")

ユーザーへの通知が行われます。

重大 ("Severe")

システムは、最後に既知の正常な構成で再起動されました。

Critical ("Critical")

正しい構成でシステムの再起動が試行されます。

不明 ("不明")

実行されるアクションは指定されていません。

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 ("インストール日")

オブジェクトがインストールされました。このプロパティには、オブジェクトがインストールされていることを示す値は必要ありません。

このプロパティは、 CIM_ManagedSystemElementから継承されます。

Name

データ型: string
アクセスの種類: 読み取り専用
修飾子: キー

管理されている機能を示すサービスの一意識別子。この機能の詳細については、オブジェクトの Description プロパティを参照してください。

このプロパティは、 CIM_ManagedSystemElementから継承されます。

PathName

データ型: string
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32API|サービス構造|QUERY_SERVICE_CONFIG|lpBinaryPathName"), DisplayName ("ファイルパス名")

サービスを実装するサービスバイナリファイルへの完全修飾パス。

例: "\SystemRoot\System32\drivers\afd.sys"

ServiceSpecificExitCode

データ型: uint32
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32API|サービス構造|SERVICE_STATUS|dwServiceSpecificExitCode"), DisplayName ("サーバー固有の終了コード")

サービスの開始中または停止中に発生するエラーのサービス固有のエラーコード。終了コードは、このクラスによって表されるサービスによって定義されます。この値は、 ExitCodeproperty 値が ERROR_SERVICE_SPECIFIC_ERROR (1066) の場合にのみ設定されます。

ServiceType

データ型: string
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32API|サービス構造|QUERY_SERVICE_CONFIG|dwServiceType"), DisplayName ("Service Type")

呼び出し元プロセスに提供されるサービス。

カーネルドライバー ("カーネルドライバー")

ファイルシステムドライバー ("ファイルシステムドライバー")

アダプター ("アダプター")

Recognizer ドライバー ("Recognizer Driver")

独自のプロセス ("独自のプロセス")

共有プロセス ("共有プロセス")

対話型プロセス ("対話型プロセス")

Started

データ型: ブール値
アクセスの種類: 読み取り専用
修飾子: DisplayName ("Started")

サービスが開始されました。

このプロパティは 、CIM_Serviceから継承されます。

StartMode

データ型: string
アクセスの種類: 読み取り専用
修飾子: オーバーライド ("StartMode")、 DisplayName ("開始モード")

Windows 基本サービスの開始モード。

このプロパティは 、CIM_Serviceから継承されます。

ブート ("Boot")

オペレーティングシステムローダーによって開始されたデバイスドライバー (ドライバーサービスに対してのみ有効)。

システム ("System")

オペレーティングシステムの初期化プロセスによって開始されたデバイスドライバー。この値は、ドライバーサービスに対してのみ指定できます。

Auto ("Auto")

システムの起動時にサービス制御マネージャーによって自動的に開始されるサービス。

Manual ("Manual")

プロセスが StartService メソッドを呼び出したときに、サービスコントロールマネージャーによって開始されるサービス。

Disabled ("Disabled")

開始できなくなったサービス。

StartName

データ型: string
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32API|サービス構造|QUERY_SERVICE_CONFIG|lpServiceStartName"), DisplayName ("Starting Account Name")

サービスを実行するアカウント名。サービスの種類によっては、アカウント名が "DomainName\Username" または UPN 形式 (Username@DomainName) の形式である場合があります。サービスプロセスは、実行時にこれら 2 つの形式のいずれかを使用してログに記録されます。アカウントが組み込みドメインに属している場合は、".\Username" を指定できます。 NULL を指定すると、サービスは LocalSystem アカウントとしてログオンします。カーネルレベルまたはシステムレベルのドライバーの場合、 StartName には、入出力 (I/O) システムがデバイスドライバーの読み込みに使用するドライバーオブジェクト名 (つまり、\FileSystem\Rdr または \Driver\Xns) が含まれます。さらに、 NULL が 指定されている場合、ドライバーは、サービス名に基づいて I/O システムによって作成された既定のオブジェクト名で実行されます。例: "DWDOM\管理"。

State

データ型: string
アクセスの種類: 読み取り/書き込み
修飾子: MappingStrings ("Win32API|サービス構造|SERVICE_STATUS|dwCurrentState "), DisplayName ("State")

基本サービスの現在の状態。

停止 ( "Stopped")

Start Pending ("Start Pending")

保留中の停止 ("保留中の停止")

実行中 ("Running")

Continue Pending ("Continue Pending")

保留中の一時停止 ("保留中の一時停止")

一時停止 ("一時停止")

不明 ("不明")

Windows Server 2008 と Windows Vista: このプロパティは読み取り専用です。

状態

データ型: string
アクセスの種類: 読み取り専用
修飾子: MaxLen (10)、 DisplayName ("Status")

オブジェクトの現在の状態。さまざまな操作状態と非操作状態を定義できます。運用状態には、"OK"、"低下"、"事前失敗" (SMART 対応ハードディスクドライブなどの要素が正常に機能している可能性がありますが、近い将来に障害が予測される可能性があります) が含まれます。非運用状態には、"Error"、"Starting"、"Stopping"、および "Service" が含まれます。後者の "サービス" は、ディスクのミラー再チェックイン、ユーザーアクセス許可リストの再読み込み、またはその他の管理作業中に適用される可能性があります。このような作業のすべてがオンラインであるわけではありませんが、マネージド要素は "OK" でも、他の状態の 1 つでもありません。

このプロパティは、 CIM_ManagedSystemElementから継承されます。

次の値があります。

OK ("OK")

エラー ("Error")

機能低下 ("Degraded")

不明 ("不明")

Pred Fail ("Pred Fail")

開始 ("開始")

停止中 ("停止中")

サービス ("Service")

ストレス ( "ストレス")

NonRecover ("NonRecover")

連絡先なし ("連絡先なし")

Lost Comm ("Lost Comm")

SystemCreationClassName

データ型: string
アクセスの種類: 読み取り専用
修飾子: 伝達 ( "CIM_System。CreationClassName")、 CIM_Key、 DisplayName ("システムクラス名")

このサービスをホストするシステムの名前を入力します。

このプロパティは 、CIM_Serviceから継承されます。

Systemname

データ型: string
アクセスの種類: 読み取り専用
修飾子: 伝達 ( "CIM_System。Name")、 CIM_Key、 DisplayName ("System Name")

このサービスをホストするシステムの名前。

このプロパティは 、CIM_Serviceから継承されます。

TagId

データ型: uint32
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32API|サービス構造|QUERY_SERVICE_CONFIG|dwTagId"), DisplayName ("Tag Id")

グループ内のこのサービスの一意のタグ値。値 0 (ゼロ) は、サービスにタグが割り当てられていないことを示します。タグは、HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\GroupOrderListにあるレジストリでタグ順序ベクトルを指定することで、読み込み順序グループ内のサービス starの並べ替えに使用できます。タグは、ブートモードまたはシステム起動モードを持つカーネルドライバーおよびファイルシステムドライバーの開始の種類のサービスに対してのみ評価されます。

注釈

Win32_BaseService クラスは、CIM_Serviceから派生します。

要件

要件	値
サポートされている最小のクライアント	Windows Vista
サポートされている最小のサーバー	Windows Server 2008
名前空間	Root\CIMV2
MOF	CIMWin32.mof
[DLL]	CIMWin32.dll

こちらもご覧ください

CIM_Service
オペレーティングシステムクラス

Win32_BaseService クラス

構文

メンバー

メソッド

プロパティ

注釈

要件

こちらもご覧ください

フィードバック

フィードバック

その他のリソース