Compartir a través de

2.2.4.7 DFS_INFO_107

  • Artículo

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

The DFS_INFO_107 structure has the following format.

 typedef struct _DFS_INFO_107 {
   [string] WCHAR* Comment;
   DWORD State;
   unsigned long Timeout;
   unsigned long PropertyFlagMask;
   unsigned long PropertyFlags;
   ULONG SecurityDescriptorLength;
   [size_is(SecurityDescriptorLength)] 
     PUCHAR pSecurityDescriptor;
 } DFS_INFO_107;

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 readability and does not affect server functionality.

State: The states that can be set for links. The following table lists such states. 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.

SecurityDescriptorLength: The length, in bytes, of the buffer that the pSecurityDescriptor field points to.

pSecurityDescriptor: A self-relative security descriptor to be associated with a DFS link. For more information on security descriptors, see [MS-DTYP] section 2.4.6.