DFS_TARGET_PRIORITY structure

Contains the priority class and rank of a specific DFS target.

Syntax


typedef struct _DFS_TARGET_PRIORITY {
  DFS_TARGET_PRIORITY_CLASS TargetPriorityClass;
  USHORT                    TargetPriorityRank;
  USHORT                    Reserved;
} DFS_TARGET_PRIORITY, *PDFS_TARGET_PRIORITY, *LPDFS_TARGET_PRIORITY;

Members

TargetPriorityClass

DFS_TARGET_PRIORITY_CLASS enumeration value that specifies the priority class of the target.

TargetPriorityRank

Specifies the priority rank value of the target. The default value is 0, which indicates the highest priority rank within a priority class.

Reserved

This member is reserved and must be zero.

Remarks

This structure is used as the TargetPriority member of the DFS_INFO_104, DFS_INFO_106, and DFS_STORAGE_INFO_1 structures. There are no functions that use this structure directly.

The order of priority classes from highest to lowest is as follows:

  • DfsGlobalHighPriorityClass
  • DfsSiteCostHighPriorityClass
  • DfsSiteCostNormalPriorityClass
  • DfsSiteCostLowPriorityClass
  • DfsGlobalLowPriorityClass

Server targets are initially grouped into global high priority, normal priority, and low priority classes. The normal priority class is then subdivided, based on Active Directory site cost, into site-cost high priority, site-cost normal priority, and site-cost low priority classes.

For example, all of the server targets with a site-cost value of 0 are first grouped into site-cost high, normal, and low priority classes. Then, all server targets with higher site costs are likewise separated into site-cost high, normal, and low priority classes. Thus, a server target with a site-cost value of 0 and a site-cost low priority class is still ranked higher than a server target with a site-cost value of 1 and site-cost high priority class.

Note that the value for a "normal priority class" is set to 0 even though it is lower in priority than DfsGlobalHighPriorityClass and DfsSiteCostHighPriorityClass. This is the default setting for priority class. Priority rank can be used to discriminate within a priority class for added granularity.

For more information about how server target priority is determined, see DFS Server Target Prioritization.

Requirements

Minimum supported client

Windows Vista

Minimum supported server

Windows Server 2008, Windows Server 2008

Header

LmDfs.h (include LmDfs.h or Lm.h)

See also

DFS Server Target Prioritization
Network Management Overview
Network Management Structures
Distributed File System (DFS) Functions
DFS_INFO_104
DFS_INFO_106
DFS_STORAGE_INFO_1
DFS_TARGET_PRIORITY_CLASS
NetDfsSetInfo

 

 

Show: