NetDfsAddRootTarget function (lmdfs.h)
Creates a domain-based or stand-alone DFS namespace or adds a new root target to an existing domain-based namespace.
Syntax
NET_API_STATUS NET_API_FUNCTION NetDfsAddRootTarget(
[in] LPWSTR pDfsPath,
[in, optional] LPWSTR pTargetPath,
[in] ULONG MajorVersion,
[in, optional] LPWSTR pComment,
[in] ULONG Flags
);
Parameters
[in] pDfsPath
Pointer to a string that specifies the Universal Naming Convention (UNC) path of a DFS namespace.
For a stand-alone DFS namespace, this string should be in the following format:
\\ServerName\DfsName
where ServerName is the name of the server that will host the new DFS root target and DfsName is the name of the DFS namespace.
For a domain-based DFS namespace, this string should be in the following format:
\\DomainName\DomDfsName
where DomainName is the name of the domain that hosts the domain-based DFS namespace and DomDfsName is the name of the new or existing domain-based DFS namespace. For compatibility reasons, DomDfsName should be the same as the name of the shared folder on the server that will host the new DFS root target.
[in, optional] pTargetPath
Pointer to a null-terminated Unicode string that specifies the UNC path of a DFS root target for the DFS namespace that is specified in the pDfsPath parameter.
For a stand-alone DFS namespace, this parameter must be NULL. For a domain-based DFS namespace, the string should be in the following format:
\\ServerName\RootShare
where ServerName is the name of the server that will host the new DFS root target and RootShare is the name of the shared folder on the server. The share specified by RootShare must already exist on the server that will host the new DFS root target. This function does not create a new share.
[in] MajorVersion
Specifies the DFS metadata version for the namespace.
If a domain-based namespace is being created, this parameter should be set as follows:
- Set it to 1 to specify Windows 2000 mode.
- Set it to 2 or higher to specify Windows Server 2008 mode.
[in, optional] pComment
Pointer to a null-terminated Unicode string that contains a comment associated with the DFS root.
[in] Flags
This parameter is reserved and must be zero.
Return value
If the function succeeds, the return value is NERR_Success.
If the domain is not at the required functional level for the specified MajorVersion, the return value is ERROR_DS_INCOMPATIBLE. This return value applies only to domain roots and a MajorVersion of 2.
If the function fails, the return value is a system error code. For a list of error codes, see System Error Codes.
Remarks
The caller must have Administrator privilege on the DFS server.
To determine the DFS metadata version that can be specified in the MajorVersion parameter, use the NetDfsGetSupportedNamespaceVersion function.
The following table shows which parameter values you should specify, according to the desired result.
| pDfsPath parameter | pTargetPath parameter | MajorVersion parameter | Result |
|---|---|---|---|
| \\DomainName\DomDfsName | \\ServerName\RootShare | 1 | Create a Windows 2000 mode domain-based DFS namespace or add a new root target to an existing one. |
| \\DomainName\DomDfsName | \\ServerName\RootShare | 2 | Create a Windows Server 2008 mode domain-based DFS namespace or add a new root target to an existing one. |
| \\DomainName\DomDfsName | \\ServerName\RootShare | 0 | Add a new root target to an existing Windows 2000 mode or Windows Server 2008 mode domain-based DFS namespace. |
| \\ServerName\DfsName | NULL | Must be 1. | Create a stand-alone DFS namespace. |
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista with SP1 |
| Minimum supported server | Windows Server 2008 |
| Target Platform | Windows |
| Header | lmdfs.h (include LmDfs.h, Lm.h) |
| Library | Netapi32.lib |
| DLL | Netapi32.dll |
See also
DFS_SUPPORTED_NAMESPACE_VERSION_INFO
Distributed File System (DFS) Functions