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 |