DFS_INFO_3

The DFS_INFO_3 structure contains detailed information about a Distributed File System (Dfs) link in a named Dfs root. The information includes Dfs name, status, and each Dfs path associated with the link.

typedef struct _DFS_INFO_3 {
    LPWSTR  EntryPath;  
    LPWSTR  Comment;  
    DWORD   State;    
    DWORD   NumberOfStorages;  
    LPDFS_STORAGE_INFO Storage; 
} DFS_INFO_3, *PDFS_INFO_3, *LPDFS_INFO_3; 

Members

EntryPath

Pointer to a null-terminated Unicode character string that specifies the Universal Naming Convention path of a Dfs link in a named Dfs root. The string can be in one of two forms. The first form is as follows:

\\Dfsname\sharename\path_to_link 

where Dfsname is the name of a Windows NT/Windows 2000 server that hosts the root of a stand-alone Dfs implementation; sharename is the name of a share published on the Dfs host server; and path_to_link specifies the path on the physical share.

The second form is as follows:

\\DomainName\DomDfsname\path_to_link 

where DomainName is the name of a Windows NT/Windows 2000 domain that hosts the Dfs root; DomDfsname is the name of the root of a domain-based Dfs implementation published in the domain's directory service; and path_to_link specifies the path on the physical share.

Windows 95/98: The DomDfsname must be identical to the name of the share that hosts the root of the domain-based Dfs.

Comment

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

State

Specifies a set of bit flags that describe the status of the Dfs link. This member must be one of the following values.

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

NumberOfStorages

Specifies the number of root shares (Dfs paths) associated with the Dfs link.

Storage

Pointer to an array of DFS_STORAGE_INFO structures. The NumberOfStorages member specifies the number of structures in the array.

Remarks

A DFS_INFO_3 structure contains one or more DFS_STORAGE_INFO structures, one for each Dfs path specified for the Dfs link.

Requirements

  Windows NT/2000: Requires Windows NT 4.0 or later.
  Windows 95/98: Unsupported.
  Header: Declared in Lmdfs.h.

See Also

Network Management Overview, Network Management Structures, Distributed File System (Dfs) Functions, DFS_STORAGE_INFO, NetDfsEnum, NetDfsGetInfo, NetDfsGetClientInfo