NewNamespaceFolder method of the MSFT_DfsNamespaceFolder class
Creates a new DFS folder in the existing namespace.
Syntax
uint32 NewNamespaceFolder(
[in] string NamespacePath,
[in] string TargetPath,
[in] string Description,
[in] uint32 Flags,
[in] uint32 State,
[in] uint32 TimeToLive,
[in] uint32 TargetState,
[in] uint32 ReferralPriorityRank,
[in] sint32 ReferralPriorityClass,
[out] MSFT_DfsNamespaceFolder cmdletOutput
);
Parameters
-
NamespacePath [in]
-
The Universal Naming Convention (UNC) path of the DFS folder to be created. The UNC path 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.
-
TargetPath [in]
-
The UNC path of the folder target of the created DFS folder.
-
Description [in]
-
A short description of the purpose of the new DFS folder.
-
Flags [in]
-
A bitwise combination of the enumeration values that represent the properties of the DFS folder.
-
InsiteReferrals (1 (0x1))
-
Enables in-site referrals for the DFS folder.
-
TargetFailback (8 (0x8))
-
Enables target failback for the DFS folder.
State [in]
The state of the DFS namespace folder.
OFFLINE (3)
Not online.
ONLINE (4)
Online.
TimeToLive [in]
The interval time, in seconds, of the time to live (TTL) of the referral.
TargetState [in]
The state of the folder target of the created DFS folder.
OFFLINE (3)
Not online. Referrals are disabled.
ONLINE (4)
Online. Referrals are enabled.
ReferralPriorityRank [in]
The priority rank of the DFS folder.
ReferralPriorityClass [in]
The priority class of the DFS folder.
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.
cmdletOutput [out]
When this method returns, contains output from the New-DFSNamespaceFolder cmdlet. This parameter is passed uninitialized.
Requirements
| Minimum supported client |
None supported |
| Minimum supported server |
Windows Server 2012 |
| Namespace |
Root\Microsoft\Windows\dfsn |
| MOF |
|
| DLL |
|