mcs/class/System.DirectoryServices/System.DirectoryServices/ReferralChasingOption.cs

   1 /******************************************************************************
   2 * The MIT License
   3 * Copyright (c) 2003 Novell Inc.,  www.novell.com
   4 *
   5 * Permission is hereby granted, free of charge, to any person obtaining  a copy
   6 * of this software and associated documentation files (the Software), to deal
   7 * in the Software without restriction, including  without limitation the rights
   8 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
   9 * copies of the Software, and to  permit persons to whom the Software is
  10 * furnished to do so, subject to the following conditions:
  11 *
  12 * The above copyright notice and this permission notice shall be included in
  13 * all copies or substantial portions of the Software.
  14 *
  15 * THE SOFTWARE IS PROVIDED AS IS, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  16 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  17 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  18 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  19 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  20 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  21 * SOFTWARE.
  22 *******************************************************************************/
  23
  24 //
  25 // System.DirectoryServices.ReferralChasingOption.cs
  26 //
  27 // Author:
  28 //   Sunil Kumar (sunilk@novell.com)
  29 //
  30 // (C)  Novell Inc.
  31 //
  32
  33 namespace System.DirectoryServices
  34 {
  35
  36         /// <summary>
  37         /// Specifies if and how referral chasing is pursued.
  38         /// </summary>
  39         /// <remarks>
  40         /// When a server determines that other servers hold relevant information,
  41         /// in part or as a whole, it may refer the client to another server to
  42         /// obtain the result. Referral chasing is the action taken by a client
  43         /// to contact the referenced server to continue the directory search.
  44         ///
  45         /// Use the constants of this enumeration to set up search preferences for
  46         /// referral chasing. The action amounts to assigning the appropriate
  47         /// fields of DirectorySearcher to elements of the ReferralChasingOption
  48         /// enumeration.
  49         ///
  50         /// The  Lightweight Directory Access Protocol (Ldap) provider supports
  51         /// external referrals for paged searches, but does not support
  52         /// subordinate referrals during paging.
  53         /// </remarks>
  54         [Serializable]
  55         public enum ReferralChasingOption
  56         {
  57                 All = 96,
  58                 External = 64,
  59                 None = 0,
  60                 Subordinate = 32
  61         }
  62 }
  63