Platform SDK: Network Management

DFS_STORAGE_INFO

The DFS_STORAGE_INFO structure contains the status of a share referenced by a Distributed File System (Dfs) link in a named Dfs root.

typedef struct _DFS_STORAGE_INFO {
    ULONG   State;  
    LPWSTR  ServerName;  
    LPWSTR  ShareName;  
} DFS_STORAGE_INFO, *PDFS_STORAGE_INFO, *LPDFS_STORAGE_INFO; 

Members

State
Specifies a set of bit flags that describe the status of the host server. Following are valid values for this member. Note that the DFS_STORAGE_STATE_OFFLINE and DFS_STORAGE_STATE_ONLINE values are mutually exclusive.
Value Meaning
DFS_STORAGE_STATE_OFFLINE The specified computer is offline or unavailable.
DFS_STORAGE_STATE_ONLINE The specified computer is available.
DFS_STORAGE_STATE_ACTIVE The specified computer is to be made the active machine. This value is optional.

ServerName
Pointer to a null-terminated Unicode character string that specifies the name of the host server that the Dfs link references.
ShareName
Pointer to a null-terminated Unicode character string that specifies the name of the share on the host server that the Dfs link references.

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_INFO_3, NetDfsEnum, NetDfsGetInfo