ResUtilGetEnvironmentWithNetName 函数 (resapi.h)
调整 资源 的环境数据,使资源使用群集网络名称来标识其位置。 该资源必须依赖于 网络名称 资源。 PRESUTIL_GET_ENVIRONMENT_WITH_NET_NAME类型定义指向此函数的指针。
语法
LPVOID ResUtilGetEnvironmentWithNetName(
[in] HRESOURCE hResource
);
参数
[in] hResource
依赖于网络名称资源的资源的句柄。
返回值
如果操作成功,函数将返回指向环境块的指针。
如果操作失败,函数将返回 NULL。 有关详细信息,请调用 GetLastError。
注解
ResUtilGetEnvironmentWithNetName 函数将环境变量追加到当前环境块。 启动资源时,将返回的环境块传递给 CreateProcess 以实现以下效果:
- 客户端和 群集 可以使用网络名称资源的名称来查找资源。
- 如果资源调用 GetComputerName、 GetComputerNameEx 或 gethostbyname,则无论当前托管资源的节点是什么,都将返回网络名称。
使用 ResUtilFreeEnvironment 销毁环境块。
不要从任何资源 DLL 入口点函数调用 ResUtilGetEnvironmentWithNetName 。 可以从工作线程安全地调用 ResUtilGetEnvironmentWithNetName。 有关详细信息,请参阅 资源 DLL 中对避免的函数调用。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 无受支持的版本 |
最低受支持的服务器 | Windows Server 2008 企业版、Windows Server 2008 Datacenter |
目标平台 | Windows |
标头 | resapi.h |
Library | ResUtils.lib |
DLL | ResUtils.dll |