ResUtilGetEnvironmentWithNetName

The ResUtilGetEnvironmentWithNetName utility function creates an environment block that appends a CLUSTER_NETWORK_NAME environment variable to the current environment block.

LPVOID WINAPI ResUtilGetEnvironmentWithNetName(
  HRESOURCE hResource  
);
 

Parameters

hResource

[in] Handle to the resource dependent on the Network Name resource used to set the CLUSTER_NETWORK_NAME environment variable.

Return Values

If the operation was successful, ResUtilGetEnvironmentWithNetName returns a pointer to the new environment block.

If the operation was unsuccessful, ResUtilGetEnvironmentWithNetName returns NULL. For more information, call the Win32 function GetLastError.

Notes to Callers

The environment variable that is appended to the current environment block is set to the Name property of the Network Name resource for the resource identified by hResource.

Callers can pass this environment block to the Win32 function CreateProcess to create an environment appropriate for Cluster Server operations.

QuickInfo

  Version: Use Windows NT Server Enterprise Edition 4.0.
  Windows CE: Unsupported.
  Header: Declared in clusapi.h.