ホーム › Networking.Clustering › PRESUTIL_SET_RESOURCE_SERVICE_ENVIRONMENT

PRESUTIL_SET_RESOURCE_SERVICE_ENVIRONMENT

コールバック

シグネチャ

DWORD PRESUTIL_SET_RESOURCE_SERVICE_ENVIRONMENT(
    LPWSTR pszServiceName,
    HRESOURCE hResource,
    PLOG_EVENT_ROUTINE pfnLogEvent,
    INT_PTR hResourceHandle
);

パラメーター

フィールド	型	説明
pszServiceName	LPWSTR	サービスの名前を格納した、null で終わる Unicode 文字列へのポインターです。
hResource	HRESOURCE	OpenClusterResource から取得した、サービスのリソースハンドルです。
pfnLogEvent	PLOG_EVENT_ROUTINE	サービスを管理するリソース DLL の LogEvent エントリポイント関数へのポインターです。
hResourceHandle	INT_PTR	LogEvent エントリポイント関数が必要とするリソースハンドルです。Open エントリポイント関数で DLL に渡されたハンドルを使用してください。

公式ドキュメント

サービスの環境データを調整し、そのサービスがクラスターネットワーク名を使用して自身の位置を識別するようにします。この関数はリソース DLL から呼び出す必要があります。PRESUTIL_SET_RESOURCE_SERVICE_ENVIRONMENT 型は、この関数へのポインターを定義します。

戻り値

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

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

解説(Remarks)

ResUtilSetResourceServiceEnvironment は ResUtilGetEnvironmentWithNetName を呼び出し、その結果として得られる環境ブロックをサービスのレジストリエントリに格納します。環境ブロックの効果の詳細については、ResUtilGetEnvironmentWithNetName を参照してください。

リソース DLL がサービスを管理する場合は、ワーカースレッドを作成し、サービスをオンラインにする際に ResUtilSetResourceServiceStartParameters と ResUtilSetResourceServiceEnvironment を使用してください。

リソース DLL のエントリポイント関数から ResUtilSetResourceServiceEnvironment を呼び出さないでください。ResUtilSetResourceServiceEnvironment はワーカースレッドから安全に呼び出せます。詳細については、Function Calls to Avoid in Resource DLLs を参照してください。

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