CreateServiceW

サービスオブジェクトを作成し、指定したサービス制御マネージャデータベースに追加する。(Unicode)

CreateServiceW hSCManager, lpServiceName, lpDisplayName, dwDesiredAccess, dwServiceType, dwStartType, dwErrorControl, lpBinaryPathName, lpLoadOrderGroup, lpdwTagId, lpDependencies, lpServiceStartName, lpPassword

hSCManager : [intptr] サービス制御マネージャデータベースへのハンドル。このハンドルは OpenSCManager 関数が返すもので、SC_MANAGER_CREATE_SERVICE アクセス権を持っている必要がある。詳細は「Service Security and Access Rights」を参照のこと。
lpServiceName : [wstr] インストールするサービスの名前。文字列の最大長は 256 文字である。サービス制御マネージャデータベースは文字の大文字小文字を保持するが、サービス名の比較は常に大文字小文字を区別しない。スラッシュ (/) とバックスラッシュ (\\) は有効なサービス名文字ではない。
lpDisplayName : [wstr] サービスを識別するためにユーザーインターフェイスプログラムが使用する表示名。この文字列の最大長は 256 文字である。名前はサービス制御マネージャ内で大文字小文字が保持される。表示名の比較は常に大文字小文字を区別しない。
dwDesiredAccess : [int] サービスへのアクセス。要求されたアクセスを許可する前に、システムは呼び出し元プロセスのアクセストークンをチェックする。値の一覧は「Service Security and Access Rights」を参照のこと。
dwServiceType : [int] 
dwStartType : [int] 
dwErrorControl : [int] 
lpBinaryPathName : [wstr] サービスバイナリファイルへの完全修飾パス。パスに空白が含まれる場合、正しく解釈されるように引用符で囲む必要がある。たとえば "d:\\my share\\myservice.exe" は "\"d:\\my share\\myservice.exe\"" のように指定する。
lpLoadOrderGroup : [wstr] このサービスがメンバとなっているロード順序グループの名前。サービスがグループに属さない場合は NULL または空文字列を指定する。
lpdwTagId : [var] lpLoadOrderGroup パラメータで指定したグループ内で一意となるタグ値を受け取る変数へのポインタ。既存のタグを変更しない場合は NULL を指定する。
lpDependencies : [wstr] このサービスより前にシステムが起動しなければならないサービスまたはロード順序グループの、null 区切りの名前からなる二重 null 終端配列へのポインタ。サービスに依存関係がない場合は NULL または空文字列を指定する。グループへの依存は、グループのすべてのメンバを開始しようとした後に少なくとも 1 つのメンバが動作していれば、このサービスが動作できることを意味する。
lpServiceStartName : [wstr] サービスが動作するアカウントの名前。サービス種別が SERVICE_WIN32_OWN_PROCESS の場合、DomainName\UserName 形式のアカウント名を使用する。サービスプロセスはこのユーザーとしてログオンされる。アカウントが組み込みドメインに属する場合は .\UserName を指定できる。
lpPassword : [wstr] lpServiceStartName パラメータで指定したアカウント名のパスワード。アカウントにパスワードがない場合や、サービスが LocalService、NetworkService、または LocalSystem アカウントで動作する場合は空文字列を指定する。詳細は「Service Record List」を参照のこと。

(プラグイン / モジュール : advapi32.dll)

解説

サービスオブジェクトを作成し、指定したサービス制御マネージャデータベースに追加する。(Unicode)

[戻り値]
関数が成功した場合、戻り値はサービスへのハンドルとなる。関数が失敗した場合、戻り値は NULL となる。拡張エラー情報を取得するには
GetLastError
を呼び出す。以下のエラーコードがサービス制御マネージャによって設定される場合がある。そのほかのエラーコードは、サービス制御マネージャが呼び出すレジストリ関数によって設定される場合がある。
（以下省略）

[備考]
CreateService
関数はサービスオブジェクトを作成し、以下のレジストリキーの下にサービスと同じ名前のキーを作成することで、サービス制御マネージャデータベースにインストールする:
HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services
CreateService、ChangeServiceConfig、ChangeServiceConfig2
で指定した情報は、このキーの下の値として保存される。サービスに対して格納される値の例を以下に示す。
（以下省略）

情報