DFS_INFO_4

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

Note  This structure is currently being evaluated and may or may not be supported in future versions.

typedef struct _DFS_INFO_4 {
    LPWSTR  EntryPath; 
    LPWSTR  Comment; 
    DWORD   State; 
    ULONG   Timeout; 
    GUID    Guid; 
    DWORD   NumberOfStorages; 
    LPDFS_STORAGE_INFO Storage; 
} DFS_INFO_4, *PDFS_INFO_4, *LPDFS_INFO_4; 

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

Timeout

Specifies the time-out, in seconds, of the Dfs link.

Guid

Specifies the GUID of the Dfs link.

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_4 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 2000.
  Windows 95/98: Unsupported.
  Header: Declared in Lmdfs.h.

See Also

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