ホーム › Networking.Clustering › PRESUTIL_SET_RESOURCE_SERVICE_START_PARAMETERS_EX

PRESUTIL_SET_RESOURCE_SERVICE_START_PARAMETERS_EX

コールバック

シグネチャ

DWORD PRESUTIL_SET_RESOURCE_SERVICE_START_PARAMETERS_EX(
    LPWSTR pszServiceName,
    SC_HANDLE schSCMHandle,
    SC_HANDLE* phService,
    DWORD dwDesiredAccess,
    PLOG_EVENT_ROUTINE pfnLogEvent,
    INT_PTR hResourceHandle
);

パラメーター

フィールド	型	説明
pszServiceName	LPWSTR	サービス名を指定する、null で終わる Unicode 文字列へのポインターです。
schSCMHandle	SC_HANDLE	サービスコントロールマネージャー (SCM) へのハンドル、または NULL です。NULL の場合、この関数は SCM へのハンドルを開こうとします。
phService	SC_HANDLE*	入力時は NULL のサービスハンドルです。出力時は、呼び出しが成功した場合は指定したサービスのハンドル、失敗した場合は NULL になります。
dwDesiredAccess	DWORD	要求するアクセス権限です。GENERIC_READ (0x80000000)、GENERIC_ALL (0x10000000)、MAXIMUM_ALLOWED (0x02000000) の任意の組み合わせを指定できます。この値が 0 の場合、未定義のエラーが返されることがあります。GENERIC_ALL を使用することは、ResUtilSetResourceServiceStartParameters を呼び出すことと同じです。
pfnLogEvent	PLOG_EVENT_ROUTINE	サービスを管理するリソース DLL の LogEvent エントリポイント関数へのポインターです。
hResourceHandle	INT_PTR	LogEvent エントリポイント関数が必要とするリソースハンドルです。Open エントリポイント関数で DLL に渡されるハンドルを使用してください。

公式ドキュメント

指定したサービスがクラスターリソースとして正しく動作するように、そのサービスの開始パラメーターを調整します。この関数はリソース DLL から呼び出す必要があります。PRESUTIL_SET_RESOURCE_SERVICE_START_PARAMETERS_EX 型は、この関数へのポインターを定義します。

戻り値

処理が成功した場合、この関数は ERROR_SUCCESS を返します。

処理が失敗した場合、この関数はシステムエラーコードを返します。

解説(Remarks)

ResUtilSetResourceServiceStartParametersEx は、サービスが無効化されていないことを確認し、サービスの構成を手動起動に変更して、障害発生時にサービスが再起動しないようにします。これにより、クラスターとリソース DLL がサービスを制御できるようになります。

リソース DLL がサービスを管理する場合は、サービスをオンラインにする前に ResUtilSetResourceServiceStartParametersEx と ResUtilSetResourceServiceEnvironment を使用してください。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)