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 Enterprise、Windows Server 2008 Datacenter
目標平台	Windows
標頭	resapi.h
程式庫	ResUtils.lib
Dll	ResUtils.dll