Win32_BaseService クラス
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 |
|
[DLL] |
|