Win32_BaseService クラスの Change メソッド

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

ChangeWMI クラスメソッドは、Win32_BaseServiceから派生したサービスオブジェクトを変更します。 Win32_LoadOrderGroup パラメーターは、実行依存関係を定義するシステムサービスのグループを表します。サービスは相互に依存するため、読み込み順序グループで指定された順序でサービスを開始する必要があります。これらの依存サービスを正しく機能させるには、継続元サービスが必要です。

このトピックでは、マネージドオブジェクト形式 (MOF) 構文を使用します。このメソッドの使用方法の詳細については、「メソッドの呼び出し」を参照してください。

構文

uint32 Change(
  [in] string  DisplayName,
  [in] string  PathName,
  [in] uint8   ServiceType,
  [in] uint8   ErrorControl,
  [in] string  StartMode,
  [in] boolean DesktopInteract,
  [in] string  StartName,
  [in] string  StartPassword,
  [in] string  LoadOrderGroup,
  [in] string  LoadOrderGroupDependencies[],
  [in] string  ServiceDependencies[]
);

パラメーター

DisplayName [in]

サービスの表示名。この文字列の長さは最大 256 文字です。名前は、サービスコントロールマネージャーで大文字と小文字が保持されます。 DisplayName の比較では、常に大文字と小文字が区別されません。

制約: Name パラメーターと同じ値を受け入れます。

例: "Atdisk"

PathName [in]

サービスを実装する実行可能ファイルへの完全修飾パス。

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

ServiceType [in]

それらを呼び出すプロセスに提供されるサービスの種類。

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

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

アダプター (4)

Recognizer ドライバー (8)

独自のプロセス (16)

共有プロセス (32)

(256)

対話型プロセス

ErrorControl [in]

起動時にこのサービスが起動しない場合のエラーの重大度。値は、障害が発生した場合にスタートアッププログラムが実行するアクションを示します。システムは、すべてのエラーをログに記録します。

無視 (0)

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

標準 (1)

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

重大 (2)

システムは、最後の適切な構成で再起動されます。

重大 (3)

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

StartMode [in]

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

ブート開始 ("Boot")

オペレーティングシステムローダーが起動するデバイスドライバー。

システムの開始 ("System")

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

自動開始 ("自動")

システムの起動時にサービスコントロールマネージャーによって自動的に開始されるサービス。

需要の開始 ("手動")

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

無効 ("無効")

開始できないサービス。

DesktopInteract [in]

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

StartName [in]

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

ユーザープリンシパル名 (UPN) 形式を使用して StartName を指定することもできます ( たとえば、Username@DomainName)。

StartPassword [in]

StartName パラメーターが指定するアカウント名のパスワード。パスワードを変更しない場合は NULL を 指定します。サービスにパスワードがない場合は、空の文字列を指定します。

Note

サービスをローカルシステムからネットワークに、またはネットワークからローカルシステムに変更する場合、 StartPassword は NULL ではなく空の文字列 ("") である必要があります。

LoadOrderGroup [in]

関連付けられているグループ名。読み込み順序グループはシステムレジストリに含まれており、サービスがオペレーティングシステムに読み込まれるシーケンスを決定します。ポインターが NULL の場合、または空の文字列を指している場合、サービスはグループに属していません。グループ間の依存関係は 、LoadOrderGroupDependencies パラメーターに一覧表示する必要があります。読み込み順序付けグループリスト内のサービスが最初に開始され、その後に読み込み順序グループリストにないグループ内のサービスが続き、その後にグループに属していないサービスが続きます。システムレジストリには、System\CurrentControlSet\Control\ServiceGroupOrderHKEY_LOCAL_MACHINE\にある読み込み順序付けグループの一覧があります。

LoadOrderGroupDependencies [in]

このサービスを開始する前に開始する必要がある読み込み順序付けグループの一覧。配列は 2 倍 null で終了します。ポインターが NULL の場合、または空の文字列を指している場合、サービスには依存関係がありません。サービスとサービスグループは同じ名前空間を共有するため、サービス名と区別するには、グループ名の前に SC_GROUP_IDENTIFIER (Winsvc.h ファイルで定義) 文字を付ける必要があります。グループへの依存関係は、グループのすべてのメンバーを開始しようとした後に、グループの少なくとも 1 つのメンバーが実行されている場合に、このサービスを実行できることを意味します。

ServiceDependencies [in]

このサービスを開始する前に開始する必要があるサービスの名前を含むリスト。配列は 2 倍 null で終了します。ポインターが NULL の場合、または空の文字列を指している場合、サービスには依存関係がありません。サービスへの依存関係は、依存するサービスが実行されている場合にのみ、このサービスを実行できることを意味します。

戻り値

次の一覧に記載されている値の 1 つ、またはエラーを示す別の値を返します。

Success

要求は受け入れられます。

サポートされていません

要求はサポートされていません。

アクセスが拒否されました

ユーザーには必要なアクセス特権がありません。

実行中の依存サービス

そのサービスは、実行中の他のサービスが依存しているので停止できません。

無効なサービス制御

要求された制御コードが無効であるか、サービスに対して受け入れられません。

サービスが制御を受け入れることができない

Win32_BaseService オブジェクトの State プロパティが 0、1、または 2 に等しいため、要求されたコントロールコードをサービスに送信できません。

サービスがアクティブではない

サービスは開始されていません。

サービス要求のタイムアウト

サービスは、開始要求に迅速に応答しません。

不明なエラー

対話型プロセス。

パスが見つかりません

サービス実行可能ファイルへのディレクトリパスが見つかりません。

サービスは既に実行されています

サービスは既に実行されています。

サービスデータベースがロックされている

新しいサービスを追加するデータベースはロックされています。

サービス依存関係の削除

このサービスが依存する依存関係は、システムから削除されます。

サービス依存関係エラー

サービスは、依存サービスから必要なサービスを見つけることができません。

サービスが無効

サービスがシステムから無効になっています。

サービスログオンに失敗しました

サービスにはシステムで実行するための正しい認証がありません。

削除対象としてマークされたサービス

このサービスはシステムから削除されています。

サービススレッドなし

サービスに実行スレッドがありません。

状態循環依存関係

サービスの開始時に循環依存があります。

状態の重複する名前

同じ名前で実行中のサービスがあります。

状態の名前が無効です

サービスの名前に無効な文字があります。

状態が無効なパラメーター

無効なパラメーターがサービスに渡されました。

状態が無効なサービスアカウント

このサービスを実行するアカウントが無効であるか、サービスを実行するためのアクセス許可がありません。

Status Service Exists

サービスは、システムから利用できるサービスのデータベースにあります。

サービスは既に一時停止しています

サービスは現在システムで一時停止されています。

その他

25 4294967295

解説

サービスをネットワークからローカルシステムに変更するには、 StartName パラメーターと StartPassword パラメーターに次の値を使用します。

StartName = "LocalSystem"
StartPassword = "" // - empty string, not NULL

サービスをローカルシステムからネットワークに変更するには、 StartName パラメーターと StartPassword パラメーターに次の値を使用します。

StartName = "NT AUTHORITY\NetworkService"
StartPassword = "" // - empty string, not NULL

要件

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

次の方法で共有

Win32_BaseService クラスの Change メソッド

構文

パラメーター

戻り値

解説

要件

関連項目

フィードバック

その他のリソース