ResUtilTerminateServiceProcessFromResDll 関数 (resapi.h)
リソース DLL によってクラスター リソースとして管理されているサービスのプロセスを終了しようとします。 PRESUTIL_TERMINATE_SERVICE_PROCESS_FROM_RES_DLL型は、この関数へのポインターを定義します。
構文
DWORD ResUtilTerminateServiceProcessFromResDll(
[in] DWORD dwServicePid,
[in] BOOL bOffline,
[out, optional] PDWORD pdwResourceState,
[in] PLOG_EVENT_ROUTINE pfnLogEvent,
[in] RESOURCE_HANDLE hResourceHandle
);
パラメーター
[in] dwServicePid
終了するサービス プロセスのプロセス ID。
[in] bOffline
リソースがオフラインになっているか、終了しているかを示します。 オフライン エントリ ポイントから、またはリソースをオフラインにするために作成されたワーカー スレッドから を呼び出す場合は 、TRUE を 指定します。 それ以外の場合は FALSE を 指定し、関数はリソースを終了していることを前提とします。
[out, optional] pdwResourceState
リソースの結果の状態を返す DWORD への省略可能なポインター。これは ClusterResourceFailed または ClusterResourceOffline のいずれかになります (リソースの状態の完全な一覧については、「 GetClusterResourceState」を参照してください)。 この情報が不要な場合は NULL を 渡します。
[in] pfnLogEvent
リソース DLL によって使用される LogEvent 関数へのポインター。 このポインターは、 スタートアップ エントリ ポイントのリソース DLL に渡されます。
[in] hResourceHandle
リソース に対するリソース モニターのハンドル。 このハンドルは 、Open エントリ ポイントのリソース DLL に渡され、リソースの インスタンス データの一部として保存する必要があります。
戻り値
操作が成功した場合、関数は ERROR_SUCCESSを返します。
操作が失敗した場合、関数は システム エラー コードを返します。
ResUtilTerminateServiceProcessFromResDll はpfnLogEvent と hResourceHandle を使用してリソース DLL のイベント ログに書き込むので、エラーのトラブルシューティングに役立つ場合があることに注意してください。
注釈
ResUtilTerminateServiceProcessFromResDll は、リソースを終了するとき、またはリソースをオフラインにする場合にのみ呼び出す必要があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | サポートなし |
| サポートされている最小のサーバー | Windows Server 2008 Datacenter、Windows Server 2008 Enterprise |
| 対象プラットフォーム | Windows |
| ヘッダー | resapi.h |
| Library | ResUtils.lib |
| [DLL] | ResUtils.dll |