NetDfsRemove

The NetDfsRemove function removes a server share from a junction point in a Distributed File System (Dfs) tree structure. If the specified share is the last share associated with the junction point, then the NetDfsRemove function also removes the junction point.

NET_API_STATUS NET_API_FUNCTION NetDfsRemove(
  LPWSTR DfsEntryPath,   // Dfs entry path for the junction point
  LPWSTR ServerName,     // name of server exporting the storage
  LPWSTR ShareName       // name of share exporting the storage
);
 

Parameters

DfsEntryPath

[in] Pointer to a null-terminated Unicode character string that specifies the Universal Naming Convention path of a junction point in a Dfs tree structure. The string must be of the form:

\\Dfsname\sharename\path-to-junction-point

where Dfsname is the name of a Windows NT server that hosts the Dfs root volume; sharename is the name of a share that is published on the Dfs host server; and path-to-junction-point specifies the path on the physical share.

ServerName

[in] Pointer to a null-terminated Unicode character string that specifies the name of the storage server that the junction point references.

ShareName

[in] Pointer to a null-terminated Unicode character string that specifies the name of the share on the storage server that the junction point references.

Return Values

If the function succeeds, the return value is NERR_Success.

If the function fails, the return value is a Win32 API error code. For a list of error codes, see Error Codes.

QuickInfo

  Windows NT: Requires version 4.0 or later.
  Windows: Unsupported.
  Windows CE: Unsupported.
  Header: Declared in lmdfs.h.
  Import Library: Use netapi32.lib.

See Also

Networking (Net) Overview, Net Functions, NetDfsAdd, NetDfsEnum