Export (0) Print
Expand All

DFS_INFO_4 structure

Contains information about a Distributed File System (DFS) root or link. This structure contains the name, status, GUID, time-out, number of targets, and information about each target of the root or link. This structure is only for use with the NetDfsEnum, NetDfsGetClientInfo, and NetDfsGetInfo functions.

Syntax


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 string that specifies the Universal Naming Convention (UNC) path of a DFS root or link.

For a link, the string can be in one of two forms. The first form is as follows:

\\ServerName\DfsName\link_path

where ServerName is the name of the root target server that hosts the stand-alone DFS namespace; DfsName is the name of the DFS namespace; and link_path is a DFS link.

The second form is as follows:

\\DomainName\DomDfsname\link_path

where DomainName is the name of the domain that hosts the domain-based DFS namespace; DomDfsname is the name of the DFS namespace; and link_path is a DFS link.

For a root, the string can be in one of two forms:

\\ServerName\DfsName

or

\\DomainName\DomDfsname

where the values of the names are the same as those described previously.

Comment

Pointer to a null-terminated Unicode string that contains a comment associated with the DFS root or link.

State

Specifies a set of bit flags that describe the DFS root or link. One DFS_VOLUME_STATE flag is set, and one DFS_VOLUME_FLAVOR flag is set. The DFS_VOLUME_FLAVORS bitmask (0x00000300) must be used to extract the DFS namespace flavor, and the DFS_VOLUME_STATES bitmask (0x0000000F) must be used to extract the DFS root or link state from this field. For an example that describes the interpretation of the flags, see the Remarks section of DFS_INFO_2.

ValueMeaning
DFS_VOLUME_STATE_OK
0x00000001

The specified DFS root or link is in the normal state.

DFS_VOLUME_STATE_INCONSISTENT
0x00000002

The internal DFS database is inconsistent with the specified DFS root or link. Attempts to repair the inconsistency have failed.

DFS_VOLUME_STATE_OFFLINE
0x00000003

The specified DFS root or link is offline or unavailable.

DFS_VOLUME_STATE_ONLINE
0x00000004

The specified DFS root or link is available.

DFS_VOLUME_FLAVOR_STANDALONE
0x00000100

The system sets this flag if the root is associated with a stand-alone DFS namespace.

DFS_VOLUME_FLAVOR_AD_BLOB
0x00000200

The system sets this flag if the root is associated with a domain-based DFS namespace.

 

Timeout

Specifies the time-out, in seconds, of the DFS root or link.

Guid

Specifies the GUID of the DFS root or link.

NumberOfStorages

Specifies the number of DFS targets.

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

Requirements

Minimum supported client

Windows Vista

Minimum supported server

Windows Server 2003

Header

LmDfs.h (include LmDfs.h or Lm.h)

See also

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

 

 

Show:
© 2015 Microsoft