2.2.3.8 DFS_INFO_8

  • Article

The DFS_INFO_8 structure contains information for a DFS root or a DFS link.

The DFS_INFO_8 structure has the following format.

 typedef struct _DFS_INFO_8 {
   [string] WCHAR* EntryPath;
   [string] WCHAR* Comment;
   DWORD State;
   unsigned long Timeout;
   GUID Guid;
   unsigned long PropertyFlags;
   unsigned long MetadataSize;
   ULONG SecurityDescriptorLength;
   [size_is(SecurityDescriptorLength)] 
     PUCHAR pSecurityDescriptor;
   DWORD NumberOfStorages;
 } DFS_INFO_8,
  *LPDFS_INFO_8;

EntryPath: A pointer to a DFS root or a DFS link path.

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: Refers to the State field of DFS_INFO_2. For more information, see section 2.2.3.2.

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

Guid: The GUID of this root or link.

PropertyFlags: Refers to the PropertyFlags field of DFS_INFO_5. For more information, see section 2.2.3.5.

MetadataSize: The size, in bytes, of the DFS metadata of the DFS namespace. For a DFS link, this MUST be 0.

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.

NumberOfStorages: The number of DFS targets for this root or link. The protocol imposes no restrictions on the number of roots or links.