dlls/wldap32/control.c

   1 /*
   2  * WLDAP32 - LDAP support for Wine
   3  *
   4  * Copyright 2005 Hans Leidekker
   5  *
   6  * This library is free software; you can redistribute it and/or
   7  * modify it under the terms of the GNU Lesser General Public
   8  * License as published by the Free Software Foundation; either
   9  * version 2.1 of the License, or (at your option) any later version.
  10  *
  11  * This library is distributed in the hope that it will be useful,
  12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  14  * Lesser General Public License for more details.
  15  *
  16  * You should have received a copy of the GNU Lesser General Public
  17  * License along with this library; if not, write to the Free Software
  18  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
  19  */
  20
  21 #include "config.h"
  22
  23 #include "wine/port.h"
  24 #include "wine/debug.h"
  25
  26 #include <stdarg.h>
  27
  28 #include "windef.h"
  29 #include "winbase.h"
  30 #include "winnls.h"
  31
  32 #ifdef HAVE_LDAP_H
  33 #include <ldap.h>
  34 #endif
  35
  36 #include "winldap_private.h"
  37 #include "wldap32.h"
  38
  39 WINE_DEFAULT_DEBUG_CHANNEL(wldap32);
  40
  41 /***********************************************************************
  42  *      ldap_control_freeA     (WLDAP32.@)
  43  *
  44  * See ldap_control_freeW.
  45  */
  46 ULONG CDECL ldap_control_freeA( LDAPControlA *control )
  47 {
  48     ULONG ret = WLDAP32_LDAP_SUCCESS;
  49 #ifdef HAVE_LDAP
  50
  51     TRACE( "(%p)\n", control );
  52     controlfreeA( control );
  53
  54 #endif
  55     return ret;
  56 }
  57
  58 /***********************************************************************
  59  *      ldap_control_freeW     (WLDAP32.@)
  60  *
  61  * Free an LDAPControl structure.
  62  *
  63  * PARAMS
  64  *  control  [I] LDAPControl structure to free.
  65  *
  66  * RETURNS
  67  *  LDAP_SUCCESS
  68  */
  69 ULONG CDECL ldap_control_freeW( LDAPControlW *control )
  70 {
  71     ULONG ret = WLDAP32_LDAP_SUCCESS;
  72 #ifdef HAVE_LDAP
  73
  74     TRACE( "(%p)\n", control );
  75     controlfreeW( control );
  76
  77 #endif
  78     return ret;
  79 }
  80
  81 /***********************************************************************
  82  *      ldap_controls_freeA     (WLDAP32.@)
  83  *
  84  * See ldap_controls_freeW.
  85  */
  86 ULONG CDECL ldap_controls_freeA( LDAPControlA **controls )
  87 {
  88     ULONG ret = WLDAP32_LDAP_SUCCESS;
  89 #ifdef HAVE_LDAP
  90
  91     TRACE( "(%p)\n", controls );
  92     controlarrayfreeA( controls );
  93
  94 #endif
  95     return ret;
  96 }
  97
  98 /***********************************************************************
  99  *      ldap_controls_freeW     (WLDAP32.@)
 100  *
 101  * Free an array of LDAPControl structures.
 102  *
 103  * PARAMS
 104  *  controls  [I] Array of LDAPControl structures to free.
 105  *
 106  * RETURNS
 107  *  LDAP_SUCCESS
 108  */
 109 ULONG CDECL ldap_controls_freeW( LDAPControlW **controls )
 110 {
 111     ULONG ret = WLDAP32_LDAP_SUCCESS;
 112 #ifdef HAVE_LDAP
 113
 114     TRACE( "(%p)\n", controls );
 115     controlarrayfreeW( controls );
 116
 117 #endif
 118     return ret;
 119 }
 120
 121 /***********************************************************************
 122  *      ldap_create_sort_controlA     (WLDAP32.@)
 123  *
 124  * See ldap_create_sort_controlW.
 125  */
 126 ULONG CDECL ldap_create_sort_controlA( WLDAP32_LDAP *ld, PLDAPSortKeyA *sortkey,
 127     UCHAR critical, PLDAPControlA *control )
 128 {
 129     ULONG ret = WLDAP32_LDAP_NOT_SUPPORTED;
 130 #ifdef HAVE_LDAP
 131     LDAPSortKeyW **sortkeyW = NULL;
 132     LDAPControlW *controlW = NULL;
 133
 134     TRACE( "(%p, %p, 0x%02x, %p)\n", ld, sortkey, critical, control );
 135
 136     if (!ld || !sortkey || !control)
 137         return WLDAP32_LDAP_PARAM_ERROR;
 138
 139     sortkeyW = sortkeyarrayAtoW( sortkey );
 140     if (!sortkeyW) return WLDAP32_LDAP_NO_MEMORY;
 141
 142     ret = ldap_create_sort_controlW( ld, sortkeyW, critical, &controlW );
 143
 144     *control = controlWtoA( controlW );
 145     if (!*control) ret = WLDAP32_LDAP_NO_MEMORY;
 146
 147     ldap_control_freeW( controlW );
 148     sortkeyarrayfreeW( sortkeyW );
 149
 150 #endif
 151     return ret;
 152 }
 153
 154 /***********************************************************************
 155  *      ldap_create_sort_controlW     (WLDAP32.@)
 156  *
 157  * Create a control for server sorted search results.
 158  *
 159  * PARAMS
 160  *  ld       [I] Pointer to an LDAP context.
 161  *  sortkey  [I] Array of LDAPSortKey structures, each specifying an
 162  *               attribute to use as a sort key, a matching rule and
 163  *               the sort order (ascending or descending).
 164  *  critical [I] Tells the server this control is critical to the
 165  *               search operation.
 166  *  control  [O] LDAPControl created.
 167  *
 168  * RETURNS
 169  *  Success: LDAP_SUCCESS
 170  *  Failure: An LDAP error code.
 171  *
 172  * NOTES
 173  *  Pass the created control as a server control in subsequent calls
 174  *  to ldap_search_ext(_s) to obtain sorted search results.
 175  */
 176 ULONG CDECL ldap_create_sort_controlW( WLDAP32_LDAP *ld, PLDAPSortKeyW *sortkey,
 177     UCHAR critical, PLDAPControlW *control )
 178 {
 179     ULONG ret = WLDAP32_LDAP_NOT_SUPPORTED;
 180 #ifdef HAVE_LDAP
 181     LDAPSortKey **sortkeyU = NULL;
 182     LDAPControl *controlU = NULL;
 183
 184     TRACE( "(%p, %p, 0x%02x, %p)\n", ld, sortkey, critical, control );
 185
 186     if (!ld || !sortkey || !control)
 187         return WLDAP32_LDAP_PARAM_ERROR;
 188
 189     sortkeyU = sortkeyarrayWtoU( sortkey );
 190     if (!sortkeyU) return WLDAP32_LDAP_NO_MEMORY;
 191
 192     ret = ldap_create_sort_control( ld, sortkeyU, critical, &controlU );
 193
 194     *control = controlUtoW( controlU );
 195     if (!*control) ret = WLDAP32_LDAP_NO_MEMORY;
 196
 197     ldap_control_free( controlU );
 198     sortkeyarrayfreeU( sortkeyU );
 199
 200 #endif
 201     return ret;
 202 }
 203
 204 /***********************************************************************
 205  *      ldap_create_vlv_controlA     (WLDAP32.@)
 206  *
 207  * See ldap_create_vlv_controlW.
 208  */
 209 INT CDECL ldap_create_vlv_controlA( WLDAP32_LDAP *ld, WLDAP32_LDAPVLVInfo *info,
 210     UCHAR critical, LDAPControlA **control )
 211 {
 212     INT ret = WLDAP32_LDAP_NOT_SUPPORTED;
 213 #ifdef HAVE_LDAP
 214     LDAPControlW *controlW = NULL;
 215
 216     TRACE( "(%p, %p, 0x%02x, %p)\n", ld, info, critical, control );
 217
 218     if (!ld || !control) return ~0UL;
 219
 220     ret = ldap_create_vlv_controlW( ld, info, critical, &controlW );
 221
 222     if (ret == WLDAP32_LDAP_SUCCESS)
 223     {
 224         *control = controlWtoA( controlW );
 225         if (!*control) ret = WLDAP32_LDAP_NO_MEMORY;
 226         ldap_control_freeW( controlW );
 227     }
 228
 229 #endif
 230     return ret;
 231 }
 232
 233 /***********************************************************************
 234  *      ldap_create_vlv_controlW     (WLDAP32.@)
 235  *
 236  * Create a virtual list view control.
 237  *
 238  * PARAMS
 239  *  ld       [I] Pointer to an LDAP context.
 240  *  info     [I] LDAPVLVInfo structure specifying a list view window.
 241  *  critical [I] Tells the server this control is critical to the
 242  *               search operation.
 243  *  control  [O] LDAPControl created.
 244  *
 245  * RETURNS
 246  *  Success: LDAP_SUCCESS
 247  *  Failure: An LDAP error code.
 248  *
 249  * NOTES
 250  *  Pass the created control in conjuction with a sort control as
 251  *  server controls in subsequent calls to ldap_search_ext(_s). The
 252  *  server will then return a sorted, contiguous subset of results
 253  *  that meets the criteria specified in the LDAPVLVInfo structure.
 254  */
 255 INT CDECL ldap_create_vlv_controlW( WLDAP32_LDAP *ld, WLDAP32_LDAPVLVInfo *info,
 256     UCHAR critical, LDAPControlW **control )
 257 {
 258     INT ret = WLDAP32_LDAP_NOT_SUPPORTED;
 259 #ifdef HAVE_LDAP
 260     LDAPControl *controlU = NULL;
 261
 262     TRACE( "(%p, %p, 0x%02x, %p)\n", ld, info, critical, control );
 263
 264     if (!ld || !control) return ~0UL;
 265
 266     ret = ldap_create_vlv_control( ld, (LDAPVLVInfo *)info, &controlU );
 267
 268     if (ret == LDAP_SUCCESS)
 269     {
 270         *control = controlUtoW( controlU );
 271         if (!*control) ret = WLDAP32_LDAP_NO_MEMORY;
 272         ldap_control_free( controlU );
 273     }
 274
 275 #endif
 276     return ret;
 277 }
 278
 279 /***********************************************************************
 280  *      ldap_encode_sort_controlA     (WLDAP32.@)
 281  *
 282  * See ldap_encode_sort_controlW.
 283  */
 284 ULONG CDECL ldap_encode_sort_controlA( WLDAP32_LDAP *ld, PLDAPSortKeyA *sortkeys,
 285     PLDAPControlA control, BOOLEAN critical )
 286 {
 287     return ldap_create_sort_controlA( ld, sortkeys, critical, &control );
 288 }
 289
 290 /***********************************************************************
 291  *      ldap_encode_sort_controlW     (WLDAP32.@)
 292  *
 293  * Create a control for server sorted search results.
 294  *
 295  * PARAMS
 296  *  ld       [I] Pointer to an LDAP context.
 297  *  sortkey  [I] Array of LDAPSortKey structures, each specifying an
 298  *               attribute to use as a sort key, a matching rule and
 299  *               the sort order (ascending or descending).
 300  *  critical [I] Tells the server this control is critical to the
 301  *               search operation.
 302  *  control  [O] LDAPControl created.
 303  *
 304  * RETURNS
 305  *  Success: LDAP_SUCCESS
 306  *  Failure: An LDAP error code.
 307  *
 308  * NOTES
 309  *  This function is obsolete. Use its equivalent
 310  *  ldap_create_sort_control instead.
 311  */
 312 ULONG CDECL ldap_encode_sort_controlW( WLDAP32_LDAP *ld, PLDAPSortKeyW *sortkeys,
 313     PLDAPControlW control, BOOLEAN critical )
 314 {
 315     return ldap_create_sort_controlW( ld, sortkeys, critical, &control );
 316 }
 317
 318 /***********************************************************************
 319  *      ldap_free_controlsA     (WLDAP32.@)
 320  *
 321  * See ldap_free_controlsW.
 322  */
 323 ULONG CDECL ldap_free_controlsA( LDAPControlA **controls )
 324 {
 325     return ldap_controls_freeA( controls );
 326 }
 327
 328 /***********************************************************************
 329  *      ldap_free_controlsW     (WLDAP32.@)
 330  *
 331  * Free an array of LDAPControl structures.
 332  *
 333  * PARAMS
 334  *  controls  [I] Array of LDAPControl structures to free.
 335  *
 336  * RETURNS
 337  *  LDAP_SUCCESS
 338  *
 339  * NOTES
 340  *  Obsolete, use ldap_controls_freeW.
 341  */
 342 ULONG CDECL ldap_free_controlsW( LDAPControlW **controls )
 343 {
 344     return ldap_controls_freeW( controls );
 345 }