ResUtilSetResourceServiceEnvironment 関数 (resapi.h)
サービスがクラスター ネットワーク名を使用してその場所を識別するように、サービスの環境データを調整します。 この関数は、 リソース DLL から呼び出す必要があります。 PRESUTIL_SET_RESOURCE_SERVICE_ENVIRONMENT型は、この関数へのポインターを定義します。
構文
DWORD ResUtilSetResourceServiceEnvironment(
[in] LPCWSTR pszServiceName,
[in] HRESOURCE hResource,
[in] PLOG_EVENT_ROUTINE pfnLogEvent,
[in] RESOURCE_HANDLE hResourceHandle
);
パラメーター
[in] pszServiceName
サービスの名前を含む null で終わる Unicode 文字列をポインターします。
[in] hResource
OpenClusterResource から取得したサービスのリソース ハンドル。
[in] pfnLogEvent
サービスを管理するリソース DLL の LogEvent エントリ ポイント関数へのポインター。
[in] hResourceHandle
LogEvent エントリ ポイント関数に必要なリソース ハンドル。 Open エントリ ポイント関数で DLL に渡されるハンドルを使用します。
戻り値
操作が成功した場合、関数は ERROR_SUCCESSを返します。
操作が失敗した場合、関数は システム エラー コードを返します。
注釈
ResUtilSetResourceServiceEnvironment は ResUtilGetEnvironmentWithNetName を 呼び出し、結果の環境ブロックをサービスのレジストリ エントリに格納します。 環境ブロックの効果の詳細については、「 ResUtilGetEnvironmentWithNetName」を参照してください。
リソース DLL がサービスを管理する場合は、ワーカー スレッドを作成し、サービスをオンラインにする際に ResUtilSetResourceServiceStartParameters と ResUtilSetResourceServiceEnvironment を使用します。
リソース DLL エントリ ポイント関数から ResUtilSetResourceServiceEnvironment を呼び出さないでください。 ResUtilSetResourceServiceEnvironment は、ワーカー スレッドから安全に呼び出すことができます。 詳細については、「 リソース DLL での回避する関数呼び出し」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | サポートなし |
| サポートされている最小のサーバー | Windows Server 2008 Enterprise、Windows Server 2008 Datacenter |
| 対象プラットフォーム | Windows |
| ヘッダー | resapi.h |
| Library | ResUtils.lib |
| [DLL] | ResUtils.dll |