通过

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 企业版、Windows Server 2008 Datacenter
目标平台 Windows
标头 resapi.h
Library ResUtils.lib
DLL ResUtils.dll

另请参阅

ResUtilGetEnvironmentWithNetName