Share via


MSFT_DfsNamespaceTargetBase class

Represents the target of a DFS namespace (DFS-N) root or link.

The following syntax is simplified from Managed Object Format (MOF) code and includes all of the inherited properties.

Syntax

[Abstract, ClassVersion("1.0"), AMENDMENT]
class MSFT_DfsNamespaceTargetBase
{
  string NamespacePath;
  sint32 ReferralPriorityClass;
  uint32 ReferralPriorityRank;
  uint32 State;
  string TargetPath;
};

Members

The MSFT_DfsNamespaceTargetBase class has these types of members:

Properties

The MSFT_DfsNamespaceTargetBase class has these properties.

NamespacePath

Data type: string

Access type: Read-only

Qualifiers: key

Gets or sets the Universal Naming Convention (UNC) path of the DFS-N root or DFS-N link for which a target is to be created.

A DFS-N root or a DFS-N link can have one of the following UNC path formats:

Server Format Domain Format
DFS-N Root \\ServerName\DFSName \\DomainName\DFSName
DFS-N Link \\ServerName\DFSName\LinkPath \\DomainName\DFSName\LinkPath

where:

  • The ServerName component represents the host name of a DFS root target of a DFS namespace.
  • The DomainName component represents the domain name of the domain that hosts the domain-based DFS namespace.
  • The DFSName component represents the DFS-N name.
  • The LinkPath component represents the path of the DFS-N link relative to the DFS root target share.

Stand-alone DFS namespaces must have links and roots with the formats shown in the first column, as they must contain a server name. Domain-based DFS namespaces can have links and roots with the formats from either column, although the second column's formats (which contain a domain name instead of a server name) are the preferred format.

ReferralPriorityClass

Data type: sint32

Access type: Read-only

Gets or sets the priority class of the DFS folder target. The default value is "Normal".

"Invalid" (-1)

Invalid priority.

"Normal" (0)

Site cost, normal priority.

"global-high" (1)

Global, high priority.

"sitecost-high" (2)

Site cost, high priority.

"sitecost-low" (3)

Site cost, low priority.

"global-low" (4)

Global, low priority.

ReferralPriorityRank

Data type: uint32

Access type: Read-only

Gets or sets the priority rank of the DFS folder target. The default value is 0.

State

Data type: uint32

Access type: Read-only

Gets or sets the state of the DFS namespace folder target. The default value is "ONLINE".

"OFFLINE" (3)

Not online. Referrals are disabled.

"ONLINE" (4)

Online. Referrals are enabled.

TargetPath

Data type: string

Access type: Read-only

Qualifiers: key

Gets or sets the UNC path of the target of a DFS-N root or a DFS-N link.

The DFS-N root target has a format of \\ServerName\ShareName, where the ServerName component is the host name of a DFS-N root target server, and the ShareName component is the share name corresponding to a namespace on the DFS-N root target server.

The DFS-N link target has a format of \\HostName\SharedName[\ObjectName]*, where:

  • The HostName component represents either the host name of a server or the domain name of a domain that hosts resources.
  • The SharedName component represents the share name or the name of the resource that is being accessed.
  • Each ObjectName component represents the name of a directory on the resource that is being accessed.

Requirements

Minimum supported client
None supported
Minimum supported server
Windows Server 2012
Namespace
Root\Microsoft\Windows\dfsn
MOF
DfsNCimProv.mof
DLL
DfsNCimProv.dll