Distributed File System Functions

The following are the Distributed File System (DFS) functions.

In this section

NetDfsAdd

Creates a new Distributed File System (DFS) link or adds targets to an existing link in a DFS namespace.

NetDfsAddFtRoot

Creates a new domain-based Distributed File System (DFS) namespace. If the namespace already exists, the function adds the specified root target to it.

NetDfsAddRootTarget

Creates a domain-based or stand-alone DFS namespace or adds a new root target to an existing domain-based namespace.

NetDfsAddStdRoot

Creates a new stand-alone Distributed File System (DFS) namespace.

NetDfsEnum

Enumerates the Distributed File System (DFS) namespaces hosted on a server or DFS links of a namespace hosted by a server.

NetDfsGetClientInfo

Retrieves information about a Distributed File System (DFS) root or link from the cache maintained by the DFS client.

NetDfsGetFtContainerSecurity

Retrieves the security descriptor of the container object for the domain-based DFS namespaces in the specified Active Directory domain.

NetDfsGetInfo

Retrieves information about a specified Distributed File System (DFS) root or link in a DFS namespace.

NetDfsGetSecurity

Retrieves the security descriptor for the root object of the specified DFS namespace.

NetDfsGetStdContainerSecurity

Retrieves the security descriptor for the container object of the specified stand-alone DFS namespace.

NetDfsGetSupportedNamespaceVersion

Determines the supported metadata version number.

NetDfsMove

Renames or moves a DFS link.

NetDfsRemove

Removes a Distributed File System (DFS) link or a specific link target of a DFS link in a DFS namespace. When removing a specific link target, the link itself is removed if the last link target of the link is removed.

NetDfsRemoveFtRoot

Removes the specified root target from a domain-based Distributed File System (DFS) namespace. If the last root target of the DFS namespace is being removed, the function also deletes the DFS namespace. A DFS namespace can be deleted without first deleting all the links in it.

NetDfsRemoveFtRootForced

Removes the specified root target from a domain-based Distributed File System (DFS) namespace, even if the root target server is offline. If the last root target of the DFS namespace is being removed, the function also deletes the DFS namespace. A DFS namespace can be deleted without first deleting all the links in it.

Note

The NetDfsRemoveFtRootForced function does not update the registry on the DFS root target server. For more information, see the Remarks section.

 

NetDfsRemoveRootTarget

Removes a DFS root target from a domain-based DFS namespace. If the root target is the last root target in the DFS namespace, this function removes the DFS namespace. This function can also be used to remove a stand-alone DFS namespace.

NetDfsRemoveStdRoot

Deletes a stand-alone Distributed File System (DFS) namespace.

NetDfsSetClientInfo

Modifies information about a Distributed File System (DFS) root or link in the cache maintained by the DFS client.

NetDfsSetFtContainerSecurity

Sets the security descriptor of the container object for the domain-based DFS namespaces in the specified Active Directory domain.

NetDfsSetInfo

Sets or modifies information about a specific Distributed File System (DFS) root, root target, link, or link target.

NetDfsSetSecurity

Sets the security descriptor for the root object of the specified DFS namespace.

NetDfsSetStdContainerSecurity

Sets the security descriptor for the container object of the specified stand-alone DFS namespace.

Note that an application invoking any of the functions may indirectly cause the local DFS Namespace server servicing the function call to perform a full synchronization of the related namespace metadata from the PDC emulator master for that domain. This full synchronization could happen even when root scalability mode is configured for that namespace.