DFS_INFO_2

The DFS_INFO_2 structure contains information about a Distributed File System (Dfs) link in a named Dfs root. The information includes Dfs name, status, and the number of Dfs paths associated with the link.

typedef struct _DFS_INFO_2 {
    LPWSTR  EntryPath; 
    LPWSTR  Comment; 
    DWORD   State; 
    DWORD   NumberOfStorages; 
} 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 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.

Remarks

The Dfs functions use the DFS_INFO_2 structure to retrieve information about a 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, NetDfsEnum, NetDfsGetInfo, NetDfsGetClientInfo