DFS_INFO_2

The DFS_INFO_2 structure contains information about a junction point in a Distributed File System (Dfs) tree structure. The information includes Dfs name, status, and the number of alternate paths associated with the junction point.

typedef struct _DFS_INFO_2 {
    LPWSTR  EntryPath;    // Dfs name for the top of the junction point
    LPWSTR  Comment;      // comment for the junction point
    DWORD   State;        // state of the junction point
    DWORD   NumberOfStorages; // number of storage shares for the junction point
} DFS_INFO_2, *PDFS_INFO_2, *LPDFS_INFO_2; 
 

Members

EntryPath

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 will 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.

Comment

Pointer to a null-terminated Unicode character string that contains a comment associated with the junction point.

State

A set of bit flags that specify the status of the junction point. This member must be one of the following values.

Value	Meaning
DFS_VOLUME_STATE_OK	The specified junction point is in the normal state.
DFS_VOLUME_STATE_INCONSISTENT	The internal Dfs database is inconsistent with the specified junction point. Attempts to repair the inconsistency have failed.
DFS_VOLUME_STATE_OFFLINE	The specified junction point is offline or unavailable.
DFS_VOLUME_STATE_ONLINE	The specified junction point is available.

NumberOfStorages

Specifies the number of alternate paths, that is, the number of shares, associated with the junction point.

Remarks

The Dfs functions use the DFS_INFO_2 structure to retrieve information about a Dfs junction point.

QuickInfo

  Windows NT: Requires version 4.0 or later.
  Windows: Unsupported.
  Windows CE: Unsupported.
  Header: Declared in lmdfs.h.

See Also

Networking (Net) Overview, Net Structures, NetDfsEnum, NetDfsGetInfo