2.2.3.4 DFS_INFO_4

  • Article

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

The DFS_INFO_4 structure has the following format.

 typedef struct _DFS_INFO_4 {
   [string] WCHAR* EntryPath;
   [string] WCHAR* Comment;
   DWORD State;
   unsigned long Timeout;
   GUID Guid;
   DWORD NumberOfStorages;
   [size_is(NumberOfStorages)] DFS_STORAGE_INFO* Storage;
 } DFS_INFO_4;

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.

NumberOfStorages: The number of DFS targets for this root or link. There are no protocol-specified restrictions on the number of targets for a root or link.

Storage: A pointer to an array of DFS_STORAGE_INFO structures containing information about each target. (For more information, see section 2.2.2.5). The NumberOfStorages member specifies the number of structures within this storage array.