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 での回避する関数呼び出し」を参照してください。

要件

こちらもご覧ください

ResUtilGetEnvironmentWithNetName