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