Partager via

2.2.4.5 DFS_INFO_105

  • Article

The DFS_INFO_105 structure contains information about a DFS root or DFS link, including comment, state, time-out, and DFS behaviors specified by property flags.

The DFS_INFO_105 structure has the following format.

 typedef struct _DFS_INFO_105 {
   [string] WCHAR* Comment;
   DWORD State;
   unsigned long Timeout;
   unsigned long PropertyFlagMask;
   unsigned long PropertyFlags;
 } DFS_INFO_105;

Comment: A pointer to a null-terminated Unicode string containing a comment associated with the DFS root or DFS link that is for informational purposes. This string has no protocol-specified restrictions on length or content. The comment is meant for human consumption and does not affect server functionality.

State: The following table lists the valid states that can be set for links. All other values are reserved and MUST NOT be used. For more information about some of these states, see section 2.2.2.13.

Value

Meaning

0x00000000

Indicates that the existing state MUST NOT be changed.

DFS_VOLUME_STATE_OFFLINE

0x00000003

The specified DFS link is offline or unavailable. This flag is valid only for a DFS link.

DFS_VOLUME_STATE_ONLINE

0x00000004

The specified DFS link is available. This flag is valid only for a DFS link.

Timeout: The time-out, in seconds, associated with the root or link and used in a DFS referral response to a DFS client.

PropertyFlagMask: Indicates which bits in the PropertyFlags field are valid.

PropertyFlags: Refers to the PropertyFlags field of DFS_INFO_103, as specified in section 2.2.4.3.