2.2.4.1 DFS_INFO_101
The DFS_INFO_101 structure describes the storage state on a root, link, root target, or link target.
The DFS_INFO_101 structure has the following format.
-
typedef struct _DFS_INFO_101 { unsigned long State; } DFS_INFO_101;
State: The state of the root, link, root target, or link target.
-
The following table lists the valid states that can be set for a root or a link. Some of these states are used to perform a server operation and are not persisted to the DFS metadata, as specified below. For more information about some of these states, see section 2.2.2.13.
-
Value
Meaning
DFS_VOLUME_STATE_OK
0x00000001
The specified DFS root or DFS link is in the normal state.
DFS_VOLUME_STATE_OFFLINE
0x00000003
The specified DFS link is offline or unavailable. This flag is valid only for a DFS link.
This state is persisted to the DFS metadata.
DFS_VOLUME_STATE_ONLINE
0x00000004
The specified DFS link is available. This flag is valid only for a DFS link.
This state is persisted to the DFS metadata.
DFS_VOLUME_STATE_RESYNCHRONIZE
0x00000010
Forces a resynchronization on the DFS root. This flag is valid only for a DFS root. This operation is an incremental synchronization that picks up only changed objects in the metadata.
This state is used to perform a server operation. It is not persisted to the DFS metadata.
DFS_VOLUME_STATE_STANDBY
0x00000020
Sets a root volume to standby mode. This flag is valid only for a clustered DFS root.
This state is used to perform a server operation. It is not persisted to the DFS metadata.
DFS_VOLUME_STATE_FORCE_SYNC
0x00000040
Forces a full resynchronization operation on the DFS root target of a specified domainv2-based DFS namespace or stand-alone DFS namespace to identify DFS links that have been added or deleted. This is not supported on a domainv1-based DFS namespace. DFS links MUST NOT be specified.
This state is used to perform a server operation. It is not persisted to the DFS metadata.
-
DFS_VOLUME_STATES (0x0000000F) is not relevant here, because it is a mask used when reading the volume state, not for setting it.
-
The following table lists the valid states that can be set for a root target or a link target.
-
Value
Meaning
DFS_STORAGE_STATE_OFFLINE
0x00000001
This target is offline and unavailable for use.
DFS_STORAGE_STATE_ONLINE
0x00000002
This target is online and available for use.