CloseServiceHandle 関数 (winsvc.h)

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

サービスコントロールマネージャーまたはサービスオブジェクトへのハンドルを閉じます。

構文

BOOL CloseServiceHandle(
  [in] SC_HANDLE hSCObject
);

パラメーター

[in] hSCObject

閉じるサービスコントロールマネージャーオブジェクトまたはサービスオブジェクトへのハンドル。サービスコントロールマネージャーオブジェクトへのハンドルは OpenSCManager 関数によって返され、サービスオブジェクトへのハンドルは OpenService 関数または CreateService 関数によって返されます。

戻り値

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

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

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

リターンコード	説明
ERROR_INVALID_HANDLE	指定されたハンドルが無効です。

注釈

CloseServiceHandle 関数は、ハンドルによって参照されるサービスコントロールマネージャーオブジェクトを破棄しません。サービスコントロールマネージャーオブジェクトを破棄することはできません。サービスオブジェクトは、 DeleteService 関数を呼び出すことによって破棄できます。

例

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

要件

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