Share via


IsDfsRoot

[The IsDfsRoot property is no longer available for use as of Windows Server 2012.]

This property is not supported.

**Windows Server 2003: **

Identifies a file share resource as a DFS root. The following table summarizes the attributes of the IsDfsRoot property.

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

Remarks

The data value for the IsDfsRoot property can be set to one of the following values.

IsDfsRoot property data value Description
FALSE The file share is not a DFS root.
TRUE The file share is a DFS root.

There can be only one DFS root per cluster. In other words, a cluster can have only one file share resource whose IsDfsRoot property is set to TRUE.

Examples

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

DWORD          IsDfsRootData = TRUE;
CLUSPROP_DWORD IsDfsRootValue;

IsDfsRootValue.Syntax.dw = CLUSPROP_SYNTAX_LIST_VALUE_DWORD;
IsDfsRootValue.cbLength  = sizeof(DWORD);
IsDfsRootValue.dw        = IsDfsRootData;

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

File Share Private Properties

CLUSPROP_DWORD