UseNetworkName Property for Generic Services

The UseNetworkName property affects the outcome of a call to the Win32 function GetComputerName.

Quick Info

Type: DWORD
Access: Read/write
Status: Optional
Function: ClusterResourceControl
Structure: CLUSPROP_DWORD
Control Code: CLUSCTL_RESOURCE_GET_PRIVATE_PROPERTIES

Remarks

When ClusterResourceControl processes the CLUSCTL_RESOURCE_GET_PRIVATE_PROPERTIES control code, it returns a property list that includes the UseNetworkName property as one of the entries. The property value portion of the entry contains a CLUSPROP_DWORD structure that is set as follows:

DWORD UseNetworkNameData = TRUE;
CLUSPROP_DWORD UseNetworkNameValue;
UseNetworkNameValue.Syntax = CLUSPROP_SYNTAX_LIST_VALUE_DWORD;
UseNetworkNameValue.cbLength = sizeof(DWORD);
UseNetworkNameValue.dw = UseNetworkNameData;
 

The data for the UseNetworkName property can be set to TRUE or FALSE. Setting it to TRUE causes calls to the Win32 function GetComputerName to return the network name of the Network Name resource on which the service is dependent. Setting it to FALSE causes GetComputerName to return the name of the node that is currently online and running the service.

QuickInfo

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