DFS_INFO_3 info  Overview  Group

[This is preliminary documentation and subject to change.]

The DFS_INFO_3 structure contains detailed information about a junction point in a Distributed File System (Dfs) tree structure. The information includes Dfs name, status, and the path for each alternate path associated with the junction point.

typedef struct _DFS_INFO_3 {

    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 servers for the junction point

#ifdef MIDL_PASS

    [size_is(NumberOfStorages)] LPDFS_STORAGE_INFO Storage;

#else

    LPDFS_STORAGE_INFO Storage; //an array (of NumberOfStorages elements) of storage-specific information.

#endif // MIDL_PASS

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

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 alternate path specified for the Dfs junction point.

See Also

DFS_STORAGE_INFO, NetDfsEnum, NetDfsGetInfo 

  .