2.2.3.9 DFS_INFO_9

  • Article

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

The DFS_INFO_9 structure has the following format.

 typedef struct _DFS_INFO_9 {
   [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;
   [size_is(NumberOfStorages)] LPDFS_STORAGE_INFO_1 Storage;
 } DFS_INFO_9,
  *LPDFS_INFO_9;

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

Comment: Pointer to a null-terminated Unicode string containing a comment associated with the DFS root or DFS link that is for informational purposes. There are no protocol-specified restrictions on the length or content of this string. The comment is meant for human readability and has no effect on 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.

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.

For information on target priority rank and class information, see section 2.2.2.6.