You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

DfsPropertyFlags.cs 5.4 KiB

7 年之前
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104
  1. /* Copyright (C) 2008-2016 Peter Palotas, Jeffrey Jangli, Alexandr Normuradov
  2. *
  3. * Permission is hereby granted, free of charge, to any person obtaining a copy
  4. * of this software and associated documentation files (the "Software"), to deal
  5. * in the Software without restriction, including without limitation the rights
  6. * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  7. * copies of the Software, and to permit persons to whom the Software is
  8. * furnished to do so, subject to the following conditions:
  9. *
  10. * The above copyright notice and this permission notice shall be included in
  11. * all copies or substantial portions of the Software.
  12. *
  13. * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  14. * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  15. * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  16. * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  17. * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  18. * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
  19. * THE SOFTWARE.
  20. */
  21. using System;
  22. using System.Diagnostics.CodeAnalysis;
  23. namespace Alphaleonis.Win32.Network
  24. {
  25. /// <summary>A set of bit flags that describe specific properties of a DFS namespace, root, or link.</summary>
  26. [SuppressMessage("Microsoft.Naming", "CA1726:UsePreferredTerms", MessageId = "Flags")]
  27. [SuppressMessage("Microsoft.Naming", "CA1704:IdentifiersShouldBeSpelledCorrectly", MessageId = "Dfs")]
  28. [Flags]
  29. public enum DfsPropertyFlags
  30. {
  31. /// <summary>No property flag.</summary>
  32. None = 0,
  33. /// <summary>DFS_PROPERTY_FLAG_INSITE_REFERRALS
  34. /// <para>
  35. /// Scope: Domain roots, stand-alone roots, and links.
  36. /// If this flag is set at the DFS root, it applies to all links; otherwise, the value of this flag is considered for each individual link.
  37. /// </para>
  38. /// <para>
  39. /// When this flag is set, a DFS referral response from a DFS server for a DFS root or link with the "INSITE" option enabled contains only
  40. /// those targets which are in the same site as the DFS client requesting the referral.
  41. /// Targets in the two global priority classes are always returned, regardless of their site location.
  42. /// </para>
  43. /// </summary>
  44. [SuppressMessage("Microsoft.Naming", "CA1704:IdentifiersShouldBeSpelledCorrectly", MessageId = "Insite")]
  45. InsiteReferrals = 1,
  46. /// <summary>DFS_PROPERTY_FLAG_ROOT_SCALABILITY
  47. /// <para>
  48. /// Scope: The entire DFS namespace for a domain-based DFS namespace only.
  49. /// </para>
  50. /// <para>
  51. /// By default, a DFS root target server polls the PDS to detect changes to the DFS metadata.
  52. /// To prevent heavy server load on the PDC, root scalability can be enabled for the DFS namespace.
  53. /// Setting this flag will cause the DFS server to poll the nearest domain controller instead of the PDC for DFS metadata changes for the common namespace.
  54. /// Note that any changes made to the metadata must still occur on the PDC, however.
  55. /// </para>
  56. /// </summary>
  57. RootScalability = 2,
  58. /// <summary>DFS_PROPERTY_FLAG_SITE_COSTING
  59. /// <para>
  60. /// Scope: The entire DFS namespace for both domain-based and stand-alone DFS namespaces.
  61. /// </para>
  62. /// <para>
  63. /// By default, targets returned in a referral response from a DFS server to a DFS client for a DFS root or link
  64. /// consists of two groups: targets in the same site as the client, and targets outside the site.
  65. /// </para>
  66. /// <para>
  67. /// If site-costing is enabled for the Active Directory, the response can have more than two groups,
  68. /// with each group containing targets with the same site cost for the specific DFS client requesting the referral.
  69. /// The groups are ordered by increasing site cost. For more information about how site-costing is used to prioritize targets.
  70. /// </para>
  71. /// </summary>
  72. SiteCosting = 4,
  73. /// <summary>DFS_PROPERTY_FLAG_TARGET_FAILBACK
  74. /// <para>
  75. /// Scope: Domain-based DFS roots, stand-alone DFS roots, and DFS links.
  76. /// If this flag is set at the DFS root, it applies to all links; otherwise, the value of this flag is considered for each individual link.
  77. /// </para>
  78. /// <para>
  79. /// When this flag is set, optimal target failback is enabled for V4 DFS clients,
  80. /// allowing them to fail back to an optimal target after failing over to a non-optimal one.
  81. /// The target failback setting is provided to the DFS client in a V4 referral response by a DFS server.
  82. /// </para>
  83. /// </summary>
  84. TargetFailback = 8,
  85. /// <summary>DFS_PROPERTY_FLAG_CLUSTER_ENABLED
  86. /// <para>Scope: Stand-alone DFS roots and links only.</para>
  87. /// <para>The DFS root is clustered to provide high availability for storage failover.</para>
  88. /// </summary>
  89. ClusterEnabled = 16,
  90. /// <summary>DFS_PROPERTY_FLAG_ABDE
  91. /// <para>Scope: Domain-based DFS roots and stand-alone DFS roots.</para>
  92. /// <para>When this flag is set, Access-Based Directory Enumeration (ABDE) mode support is enabled on the entire DFS root target share of the DFS namespace.</para>
  93. /// </summary>
  94. AccessBasedDirectoryEnumeration = 32
  95. }
  96. }