DFS_INFO_101 structure

Describes the state of storage on a DFS root, link, root target, or link target.

Syntax

typedef struct _DFS_INFO_101 {
  DWORD State;
} DFS_INFO_101, *PDFS_INFO_101, *LPDFS_INFO_101;

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. The storage states can only be set on DFS root targets or DFS link targets. The DFS volume states can only be set on a DFS namespace root or DFS link and not on individual targets.

Value	Meaning
DFS_STORAGE_STATE_OFFLINE 0x00000001	The DFS storage is offline. Note  This value cannot be set for a DFS root target on a server that is running Windows Server 2003.
DFS_STORAGE_STATE_ONLINE 0x00000002	The DFS storage is online.
DFS_STORAGE_STATE_ACTIVE 0x00000004	The DFS storage is active. This value is only for use with the NetDfsSetClientInfo function.
DFS_VOLUME_STATE_OK 0x00000001	The specified DFS root or link is in the normal state. Windows 2000 Server:  This value is read-only.
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. This value is read-only.
DFS_VOLUME_STATE_OFFLINE 0x00000003	The specified DFS root or link is offline or unavailable. Note  This value cannot be set for the DFS namespace root on a server that is running Windows Server 2003.
DFS_VOLUME_STATE_ONLINE 0x00000004	The specified DFS root or link is available. Note  This value cannot be set for the DFS namespace root on a server that is running Windows Server 2003.
DFS_VOLUME_STATE_RESYNCHRONIZE 0x00000010	Forces a resynchronization on the DFS root target. This flag is valid only for a DFS root target, and is write-only. Note  This value cannot be set for the DFS root target on a server that is running Windows 2000 Server.
DFS_VOLUME_STATE_STANDBY 0x00000020	Puts a root volume in standby mode. This flag is valid for a clustered DFS namespace only. Note  This value cannot be set for the DFS root target on a server that is running Windows 2000 Server.

 

Requirements

See also

Network Management Overview

Network Management Structures

Distributed File System (DFS) Functions

NetDfsSetClientInfo

NetDfsSetInfo

Send comments about this topic to Microsoft

Build date: 9/6/2011