mcs/class/Novell.Directory.Ldap/Novell.Directory.Ldap.Rfc2251/RfcExtendedRequest.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 // Novell.Directory.Ldap.Rfc2251.RfcExtendedRequest.cs
  25 //
  26 // Author:
  27 //   Sunil Kumar (Sunilk@novell.com)
  28 //
  29 // (C) 2003 Novell, Inc (http://www.novell.com)
  30 //
  31
  32 using System;
  33 using Novell.Directory.Ldap.Asn1;
  34 using Novell.Directory.Ldap;
  35
  36 namespace Novell.Directory.Ldap.Rfc2251
  37 {
  38
  39         /// <summary> Represents an Ldap Extended Request.
  40         ///
  41         /// <pre>
  42         /// ExtendedRequest ::= [APPLICATION 23] SEQUENCE {
  43         /// requestName      [0] LdapOID,
  44         /// requestValue     [1] OCTET STRING OPTIONAL }
  45         /// </pre>
  46         /// </summary>
  47         public class RfcExtendedRequest:Asn1Sequence, RfcRequest
  48         {
  49
  50                 /// <summary> Context-specific TAG for optional requestName.</summary>
  51                 public const int REQUEST_NAME = 0;
  52                 /// <summary> Context-specific TAG for optional requestValue.</summary>
  53                 public const int REQUEST_VALUE = 1;
  54
  55                 //*************************************************************************
  56                 // Constructors for ExtendedRequest
  57                 //*************************************************************************
  58
  59                 /// <summary> Constructs an extended request.
  60                 ///
  61                 /// </summary>
  62                 /// <param name="requestName">The OID for this extended operation.
  63                 /// </param>
  64                 public RfcExtendedRequest(RfcLdapOID requestName):this(requestName, null)
  65                 {
  66                         return ;
  67                 }
  68
  69                 /// <summary> Constructs an extended request.
  70                 ///
  71                 /// </summary>
  72                 /// <param name="requestName">The OID for this extended operation.
  73                 /// </param>
  74                 /// <param name="requestValue">An optional request value.
  75                 /// </param>
  76                 public RfcExtendedRequest(RfcLdapOID requestName, Asn1OctetString requestValue):base(2)
  77                 {
  78                         add(new Asn1Tagged(new Asn1Identifier(Asn1Identifier.CONTEXT, false, REQUEST_NAME), requestName, false));
  79                         if (requestValue != null)
  80                                 add(new Asn1Tagged(new Asn1Identifier(Asn1Identifier.CONTEXT, false, REQUEST_VALUE), requestValue, false));
  81                         return ;
  82                 }
  83
  84
  85                 /// <summary> Constructs an extended request from an existing request.
  86                 ///
  87                 /// </summary>
  88                 /// <param name="origRequest">Asn1Object of existing request
  89                 /// </param>
  90                 /* package */
  91                 public RfcExtendedRequest(Asn1Object[] origRequest):base(origRequest, origRequest.Length)
  92                 {
  93                         return ;
  94                 }
  95                 //*************************************************************************
  96                 // Accessors
  97                 //*************************************************************************
  98
  99                 /// <summary> Override getIdentifier to return an application-wide id.
 100                 ///
 101                 /// <pre>
 102                 /// ID = CLASS: APPLICATION, FORM: CONSTRUCTED, TAG: 23.
 103                 /// </pre>
 104                 /// </summary>
 105                 public override Asn1Identifier getIdentifier()
 106                 {
 107                         return new Asn1Identifier(Asn1Identifier.APPLICATION, true, LdapMessage.EXTENDED_REQUEST);
 108                 }
 109
 110                 public RfcRequest dupRequest(System.String base_Renamed, System.String filter, bool request)
 111                 {
 112                         // Just dup the original request
 113                         return new RfcExtendedRequest(toArray());
 114                 }
 115                 public System.String getRequestDN()
 116                 {
 117                         return null;
 118                 }
 119         }
 120 }