OpenSCManagerA 関数 (winsvc.h)
指定したコンピューターでサービス コントロール マネージャーへの接続を確立し、指定したサービス コントロール マネージャー データベースを開きます。
構文
SC_HANDLE OpenSCManagerA(
[in, optional] LPCSTR lpMachineName,
[in, optional] LPCSTR lpDatabaseName,
[in] DWORD dwDesiredAccess
);
パラメーター
[in, optional] lpMachineName
ターゲット コンピューターの名前。 ポインターが NULL または空の文字列を指している場合、関数はローカル コンピューター上のサービス コントロール マネージャーに接続します。
[in, optional] lpDatabaseName
サービス コントロール マネージャー データベースの名前。 このパラメーターは、SERVICES_ACTIVE_DATABASEに設定する必要があります。 NULL の場合、SERVICES_ACTIVE_DATABASE データベースは既定で開かれます。
[in] dwDesiredAccess
サービス コントロール マネージャーへのアクセス。 アクセス権の一覧については、「サービス セキュリティとアクセス権の」を参照してください。
要求されたアクセス権を付与する前に、システムは呼び出し元プロセスのアクセス トークンを、サービス制御マネージャーに関連付けられているセキュリティ記述子の随意アクセス制御リストと照合します。
SC_MANAGER_CONNECTアクセス権は、この関数を呼び出すことによって暗黙的に指定されます。
戻り値
関数が成功した場合、戻り値は指定されたサービス コントロール マネージャー データベースへのハンドルです。
関数が失敗した場合、戻り値は NULL です。 拡張エラー情報を取得するには、GetLastError
SCM では、次のエラー コードを設定できます。 その他のエラー コードは、SCM によって呼び出されるレジストリ関数によって設定できます。
| リターン コード | 形容 |
|---|---|
|
要求されたアクセスが拒否されました。 |
|
指定されたデータベースが存在しません。 |
備考
プロセスで OpenSCManager 関数を使用してサービス コントロール マネージャー データベースへのハンドルを開くと、システムは要求されたアクセス権を付与する前にセキュリティ チェックを実行します。 詳細については、「サービスのセキュリティとアクセス権の」を参照してください。
別のコンピューター上のサービスに接続するときに、現在のユーザーが適切なアクセス権を持っていない場合、OpenSCManager 関数呼び出しは失敗します。 サービスにリモートで接続するには、LOGON32_LOGON_NEW_CREDENTIALSを使用して
CreateService 関数で使用できるデータベース ハンドルを開くことができるのは、管理者特権を持つプロセスだけです。
返されるハンドルは、OpenSCManager 関数を呼び出したプロセスに対してのみ有効です。 これは、CloseServiceHandle 関数を呼び出すことによって閉じることができます。
例
例については、「サービスの構成の変更」を参照してください。
手記
winsvc.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして OpenSCManager を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows XP [デスクトップ アプリのみ] |
| サポートされる最小サーバー | Windows Server 2003 [デスクトップ アプリのみ] |
| ターゲット プラットフォーム の |
ウィンドウズ |
| ヘッダー | winsvc.h (Windows.h を含む) |
| ライブラリ | Advapi32.lib |
| DLL | Advapi32.dll |
関連項目
CloseServiceHandle の
CreateService の
EnumServicesStatusEx の