ResUtilGetEnvironmentWithNetName 函数 (resapi.h)

调整资源的环境数据，使资源使用群集网络名称来标识其位置。该资源必须依赖于网络名称资源。 PRESUTIL_GET_ENVIRONMENT_WITH_NET_NAME类型定义指向此函数的指针。

语法

LPVOID ResUtilGetEnvironmentWithNetName(
  [in] HRESOURCE hResource
);

[in] hResource

依赖于网络名称资源的资源的句柄。

如果操作成功，函数将返回指向环境块的指针。

如果操作失败，函数将返回 NULL。有关详细信息，请调用 GetLastError。

ResUtilGetEnvironmentWithNetName 函数将环境变量追加到当前环境块。启动资源时，将返回的环境块传递给 CreateProcess 以实现以下效果：

客户端和群集可以使用网络名称资源的名称来查找资源。
如果资源调用 GetComputerName、 GetComputerNameEx 或 gethostbyname，则无论当前托管资源的节点是什么，都将返回网络名称。

如果 hResource 标识的资源不依赖于网络名称资源， 则 ResUtilGetEnvironmentWithNetName 返回 NULL。

使用 ResUtilFreeEnvironment 销毁环境块。

不要从任何资源 DLL 入口点函数调用 ResUtilGetEnvironmentWithNetName 。可以从工作线程安全地调用 ResUtilGetEnvironmentWithNetName。有关详细信息，请参阅资源 DLL 中对避免的函数调用。

要求	值
最低受支持的客户端	无受支持的版本
最低受支持的服务器	Windows Server 2008 企业版、Windows Server 2008 Datacenter
目标平台	Windows
标头	resapi.h
Library	ResUtils.lib
DLL	ResUtils.dll