2.2.2.7 DFS_TARGET_PRIORITY

The DFS_TARGET_PRIORITY structure relates to the NetrDfsSetInfo and NetrDfsSetInfo2 methods when used to set the priority of a DFS target in referrals from a server. It also relates to the DFS_STORAGE_INFO_1 structure that the NetrDfsEnum, NetrDfsEnumEx, and NetrDfsGetInfo methods return. The structure defines the priority of a DFS target. The DFS targets can be prioritized independently of site cost. The DFS target priority is manually assigned to link targets and root targets and allows for load balancing of clients.

The DFS_TARGET_PRIORITY structure has the following format.

 typedef struct _DFS_TARGET_PRIORITY {
   DFS_TARGET_PRIORITY_CLASS TargetPriorityClass;
   unsigned short TargetPriorityRank;
   unsigned short Reserved;
 } DFS_TARGET_PRIORITY;

TargetPriorityClass: The DFS_TARGET_PRIORITY_CLASS enumeration value that specifies the priority class of the target. For more information, see section 2.2.2.8.

TargetPriorityRank: The priority rank of the target, ranging in value from 0x0000 to 0x001F, where 0x0000 is the highest rank. Priority ranks apply only within a priority class, not across priority classes.

Reserved: MUST be set to 0 by the sender and ignored by the receiver.