Share via


UseNetworkName

[The UseNetworkName property is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions.]

Affects the outcome of a call to the GetComputerName function.UseNetworkName is a property of a Generic Application resource. The following table summarizes the attributes of the UseNetworkName property.

Attribute Value
Data type DWORD
Access Read/write
Status Optional
Structure CLUSPROP_DWORD
Minimum FALSE
Maximum TRUE
Default FALSE

Remarks

When an application being managed as a Generic Application resource calls GetComputerName, the UseNetworkName property determines what kind of data is returned as follows.

UseNetworkName value Name returned by GetComputerName
TRUE The name of the network, as stored in the Name private property of the Network Name resource on which the application depends.
FALSE The name of the node currently running the application.

Examples

The property value portion of a property list entry for UseNetworkName can be set with the following example code.

DWORD          UseNetworkNameData = TRUE;
CLUSPROP_DWORD UseNetworkNameValue;

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

Requirements

Minimum supported client
None supported
Minimum supported server
Windows Server 2003 Enterprise, Windows Server 2003 Datacenter
End of server support
Windows Server 2003 Datacenter, Windows Server 2003 Enterprise

See also

Generic Application Private Properties

CLUSPROP_DWORD

GetComputerName

Name