DeleteService 関数 (winsvc.h)

[アーティクル]
03/09/2024

指定したサービスをサービスコントロールマネージャーデータベースから削除するマークを付けます。

構文

BOOL DeleteService(
  [in] SC_HANDLE hService
);

パラメーター

[in] hService

サービスへのハンドル。このハンドルは OpenService または CreateService 関数によって返され、DELETE アクセス権が必要です。詳細については、「サービスセキュリティとアクセス権」を参照してください。

戻り値

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。詳細なエラー情報を得るには、GetLastError を呼び出します。

次のエラーコードは、サービスコントロールマネージャーによって設定される場合があります。その他は、サービスコントロールマネージャーによって呼び出されるレジストリ関数によって設定される場合があります。

リターンコード	説明
ERROR_ACCESS_DENIED	ハンドルに DELETE アクセス権がありません。
ERROR_INVALID_HANDLE	指定されたハンドルが無効です。
ERROR_SERVICE_MARKED_FOR_DELETE	指定されたサービスは既に削除対象としてマークされています。

注釈

DeleteService 関数は、サービスコントロールマネージャーデータベースから削除するサービスをマークします。 CloseServiceHandle 関数の呼び出しによってサービスに対するすべての開いているハンドルが閉じられ、サービスが実行されていないまで、データベースエントリは削除されません。実行中のサービスは、SERVICE_CONTROL_STOPコントロールコードを使用した ControlService 関数の呼び出しによって停止されます。サービスを停止できない場合は、システムの再起動時にデータベースエントリが削除されます。

サービスコントロールマネージャーは、サービスキーとそのサブキーをレジストリから削除することで、サービスを削除します。

例

例については、「サービスの削除」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows XP (デスクトップアプリのみ)
サポートされている最小のサーバー	Windows Server 2003 (デスクトップアプリのみ)
対象プラットフォーム	Windows
ヘッダー	winsvc.h (Windows.h を含む)
Library	Advapi32.lib
[DLL]	Advapi32.dll