ホーム › Networking.Clustering › PRESUTIL_TERMINATE_SERVICE_PROCESS_FROM_RES_DLL

PRESUTIL_TERMINATE_SERVICE_PROCESS_FROM_RES_DLL

コールバック

シグネチャ

DWORD PRESUTIL_TERMINATE_SERVICE_PROCESS_FROM_RES_DLL(
    DWORD dwServicePid,
    BOOL bOffline,
    DWORD* pdwResourceState,
    PLOG_EVENT_ROUTINE pfnLogEvent,
    INT_PTR hResourceHandle
);

パラメーター

フィールド	型	説明
dwServicePid	DWORD	終了するサービスプロセスのプロセス ID です。
bOffline	BOOL	リソースをオフラインにしようとしているのか、それとも終了しようとしているのかを示します。Offline エントリポイントから呼び出す場合、またはリソースをオフラインにするために作成したワーカースレッドから呼び出す場合は TRUE を指定します。それ以外の場合は FALSE を指定します。この場合、関数はリソースを終了しようとしているものとみなします。
pdwResourceState	DWORD*	リソースの結果としての状態を受け取る DWORD への省略可能なポインターです。状態は ClusterResourceFailed または ClusterResourceOffline のいずれかになります (リソースの状態の完全な一覧については GetClusterResourceState を参照してください)。この情報が不要な場合は NULL を渡します。
pfnLogEvent	PLOG_EVENT_ROUTINE	使用しているリソース DLL の LogEvent 関数へのポインターです。このポインターは、Startup エントリポイントでリソース DLL に渡されます。
hResourceHandle	INT_PTR	リソースに対する Resource Monitor のハンドルです。このハンドルは Open エントリポイントでリソース DLL に渡され、リソースのインスタンスデータの一部として保存する必要があります。

公式ドキュメント

リソース DLL によってクラスターリソースとして管理されているサービスのプロセスを終了しようと試みます。PRESUTIL_TERMINATE_SERVICE_PROCESS_FROM_RES_DLL 型は、この関数へのポインターを定義します。

戻り値

操作が成功した場合、関数は ERROR_SUCCESS を返します。

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

ResUtilTerminateServiceProcessFromResDll は、pfnLogEvent と hResourceHandle を使用してリソース DLL のイベントログに書き込む点に注意してください。これは失敗の原因を調査する際に役立つことがあります。

解説(Remarks)

ResUtilTerminateServiceProcessFromResDll は、リソースを終了するとき、またはリソースをオフラインにするときにのみ呼び出してください。

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