ResUtilSetResourceServiceStartParametersEx 関数 (resapi.h)
クラスター リソースとして正しく動作するように、指定した サービス の開始パラメーターを調整 します。 リソース DLL から呼び出す必要があります。 PRESUTIL_SET_RESOURCE_SERVICE_START_PARAMETERS_EX型は、この関数へのポインターを定義します。
構文
DWORD ResUtilSetResourceServiceStartParametersEx(
[in] LPCWSTR pszServiceName,
[in] SC_HANDLE schSCMHandle,
[in, out] LPSC_HANDLE phService,
[in] DWORD dwDesiredAccess,
[in] PLOG_EVENT_ROUTINE pfnLogEvent,
[in] RESOURCE_HANDLE hResourceHandle
);
パラメーター
[in] pszServiceName
サービスの名前を指定する null で終わる Unicode 文字列へのポインター。
[in] schSCMHandle
サービス コントロール マネージャー (SCM) または NULL へのハンドル。 NULL の場合、関数は SCM へのハンドルを開こうとします。
[in, out] phService
入力時に、 NULL サービス ハンドル。 出力時に、呼び出しが成功した場合は、指定されたサービスを処理します。それ以外の場合 は NULL。
[in] dwDesiredAccess
要求されたアクセス特権。 これは、 GENERIC_READ (0x80000000 )、 GENERIC_ALL (0x10000000 )、または MAXIMUM_ALLOWED (0x02000000) の任意の組み合わせです。 この値がゼロ (0) の場合は、未定義のエラーが返される可能性があります。 GENERIC_ALLの使用は、ResUtilSetResourceServiceStartParameters の呼び出しと同じです。
[in] pfnLogEvent
サービスを管理するリソース DLL の LogEvent エントリ ポイント関数へのポインター。
[in] hResourceHandle
LogEvent エントリ ポイント関数に必要なリソース ハンドル。 Open エントリ ポイント関数で DLL に渡されるハンドルを使用します。
戻り値
操作が成功した場合、関数は ERROR_SUCCESSを返します。
操作が失敗した場合、関数は システム エラー コードを返します。
注釈
ResUtilSetResourceServiceStartParametersEx は、サービスが無効でないことを確認し、サービス構成を手動で開始するように変更し、障害に対応してサービスが再起動しないようにします。 これにより、 クラスター とリソース DLL がサービスを制御できるようになります。
リソース DLL がサービスを管理する場合は、サービスをオンラインにする前に、 ResUtilSetResourceServiceStartParametersEx と ResUtilSetResourceServiceEnvironment を使用します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | サポートなし |
| サポートされている最小のサーバー | Windows Server 2012 |
| 対象プラットフォーム | Windows |
| ヘッダー | resapi.h |
| Library | ResUtils.lib |
| [DLL] | ResUtils.dll |