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 |
| 程式庫 | ResUtils.lib |
| Dll | ResUtils.dll |