2.2.3.6 DFS_INFO_6

  • Article

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

The DFS_INFO_6 structure has the following format.

 typedef struct _DFS_INFO_6 {
   [string] WCHAR* EntryPath;
   [string] WCHAR* Comment;
   DWORD State;
   unsigned long Timeout;
   GUID Guid;
   unsigned long PropertyFlags;
   unsigned long MetadataSize;
   DWORD NumberOfStorages;
   [size_is(NumberOfStorages)] DFS_STORAGE_INFO_1* Storage;
 } DFS_INFO_6;

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 of the DFS metadata of the DFS namespace. This MUST be 0 for a DFS link.

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

Storage: A pointer to an array of DFS_STORAGE_INFO_1 structures containing information about each target. The NumberOfStorages member specifies the number of structures within this storage array.