From 9003877dfb31f0d25b84cbe188ae3a88fb9752e9 Mon Sep 17 00:00:00 2001 From: Hans Leidekker Date: Mon, 19 Sep 2022 13:38:43 +0200 Subject: [PATCH] wldap32: Get rid of the function documentation. --- dlls/wldap32/add.c | 75 -------------- dlls/wldap32/ber.c | 177 -------------------------------- dlls/wldap32/bind.c | 123 ---------------------- dlls/wldap32/compare.c | 73 ------------- dlls/wldap32/control.c | 96 ----------------- dlls/wldap32/delete.c | 67 ------------ dlls/wldap32/dn.c | 60 ----------- dlls/wldap32/error.c | 57 ----------- dlls/wldap32/extended.c | 61 ----------- dlls/wldap32/init.c | 125 ----------------------- dlls/wldap32/misc.c | 221 ---------------------------------------- dlls/wldap32/modify.c | 75 -------------- dlls/wldap32/modrdn.c | 64 ------------ dlls/wldap32/option.c | 29 ------ dlls/wldap32/page.c | 17 ---- dlls/wldap32/parse.c | 95 ----------------- dlls/wldap32/rename.c | 41 +------- dlls/wldap32/search.c | 117 --------------------- dlls/wldap32/value.c | 84 --------------- 19 files changed, 1 insertion(+), 1656 deletions(-) diff --git a/dlls/wldap32/add.c b/dlls/wldap32/add.c index 282fd327ba3..2afe4fa2b33 100644 --- a/dlls/wldap32/add.c +++ b/dlls/wldap32/add.c @@ -31,8 +31,6 @@ WINE_DEFAULT_DEBUG_CHANNEL(wldap32); /*********************************************************************** * ldap_addA (WLDAP32.@) - * - * See ldap_addW. */ ULONG CDECL ldap_addA( LDAP *ld, char *dn, LDAPModA **attrs ) { @@ -57,23 +55,6 @@ exit: /*********************************************************************** * ldap_addW (WLDAP32.@) - * - * Add an entry to a directory tree (asynchronous operation). - * - * PARAMS - * ld [I] Pointer to an LDAP context. - * dn [I] DN of the entry to add. - * attrs [I] Pointer to an array of LDAPModW structures, each - * specifying an attribute and its values to add. - * - * RETURNS - * Success: Message ID of the add operation. - * Failure: An LDAP error code. - * - * NOTES - * Call ldap_result with the message ID to get the result of - * the operation. Cancel the operation by calling ldap_abandon - * with the message ID. */ ULONG CDECL ldap_addW( LDAP *ld, WCHAR *dn, LDAPModW **attrs ) { @@ -88,8 +69,6 @@ ULONG CDECL ldap_addW( LDAP *ld, WCHAR *dn, LDAPModW **attrs ) /*********************************************************************** * ldap_add_extA (WLDAP32.@) - * - * See ldap_add_extW. */ ULONG CDECL ldap_add_extA( LDAP *ld, char *dn, LDAPModA **attrs, LDAPControlA **serverctrls, LDAPControlA **clientctrls, ULONG *message ) @@ -120,26 +99,6 @@ exit: /*********************************************************************** * ldap_add_extW (WLDAP32.@) - * - * Add an entry to a directory tree (asynchronous operation). - * - * PARAMS - * ld [I] Pointer to an LDAP context. - * dn [I] DN of the entry to add. - * attrs [I] Pointer to an array of LDAPModW structures, each - * specifying an attribute and its values to add. - * serverctrls [I] Array of LDAP server controls. - * clientctrls [I] Array of LDAP client controls. - * message [O] Message ID of the add operation. - * - * RETURNS - * Success: LDAP_SUCCESS - * Failure: An LDAP error code. - * - * NOTES - * Call ldap_result with the message ID to get the result of - * the operation. The serverctrls and clientctrls parameters are - * optional and should be set to NULL if not used. */ ULONG CDECL ldap_add_extW( LDAP *ld, WCHAR *dn, LDAPModW **attrs, LDAPControlW **serverctrls, LDAPControlW **clientctrls, ULONG *message ) @@ -173,8 +132,6 @@ exit: /*********************************************************************** * ldap_add_ext_sA (WLDAP32.@) - * - * See ldap_add_ext_sW. */ ULONG CDECL ldap_add_ext_sA( LDAP *ld, char *dn, LDAPModA **attrs, LDAPControlA **serverctrls, LDAPControlA **clientctrls ) @@ -205,24 +162,6 @@ exit: /*********************************************************************** * ldap_add_ext_sW (WLDAP32.@) - * - * Add an entry to a directory tree (synchronous operation). - * - * PARAMS - * ld [I] Pointer to an LDAP context. - * dn [I] DN of the entry to add. - * attrs [I] Pointer to an array of LDAPModW structures, each - * specifying an attribute and its values to add. - * serverctrls [I] Array of LDAP server controls. - * clientctrls [I] Array of LDAP client controls. - * - * RETURNS - * Success: LDAP_SUCCESS - * Failure: An LDAP error code. - * - * NOTES - * The serverctrls and clientctrls parameters are optional and - * should be set to NULL if not used. */ ULONG CDECL ldap_add_ext_sW( LDAP *ld, WCHAR *dn, LDAPModW **attrs, LDAPControlW **serverctrls, LDAPControlW **clientctrls ) @@ -256,8 +195,6 @@ exit: /*********************************************************************** * ldap_add_sA (WLDAP32.@) - * - * See ldap_add_sW. */ ULONG CDECL ldap_add_sA( LDAP *ld, char *dn, LDAPModA **attrs ) { @@ -282,18 +219,6 @@ exit: /*********************************************************************** * ldap_add_sW (WLDAP32.@) - * - * Add an entry to a directory tree (synchronous operation). - * - * PARAMS - * ld [I] Pointer to an LDAP context. - * dn [I] DN of the entry to add. - * attrs [I] Pointer to an array of LDAPModW structures, each - * specifying an attribute and its values to add. - * - * RETURNS - * Success: LDAP_SUCCESS - * Failure: An LDAP error code. */ ULONG CDECL ldap_add_sW( LDAP *ld, WCHAR *dn, LDAPModW **attrs ) { diff --git a/dlls/wldap32/ber.c b/dlls/wldap32/ber.c index f3b18e530b4..82ab6116455 100644 --- a/dlls/wldap32/ber.c +++ b/dlls/wldap32/ber.c @@ -33,18 +33,6 @@ WINE_DEFAULT_DEBUG_CHANNEL(wldap32); /*********************************************************************** * ber_alloc_t (WLDAP32.@) - * - * Allocate a berelement structure. - * - * PARAMS - * options [I] Must be LBER_USE_DER. - * - * RETURNS - * Success: Pointer to an allocated berelement structure. - * Failure: NULL - * - * NOTES - * Free the berelement structure with ber_free. */ BerElement * CDECL ber_alloc_t( int options ) { @@ -62,86 +50,32 @@ BerElement * CDECL ber_alloc_t( int options ) return ret; } - /*********************************************************************** * ber_bvdup (WLDAP32.@) - * - * Copy a berval structure. - * - * PARAMS - * berval [I] Pointer to the berval structure to be copied. - * - * RETURNS - * Success: Pointer to a copy of the berval structure. - * Failure: NULL - * - * NOTES - * Free the copy with ber_bvfree. */ BERVAL * CDECL ber_bvdup( BERVAL *berval ) { return bervalWtoW( berval ); } - /*********************************************************************** * ber_bvecfree (WLDAP32.@) - * - * Free an array of berval structures. - * - * PARAMS - * berval [I] Pointer to an array of berval structures. - * - * RETURNS - * Nothing. - * - * NOTES - * Use this function only to free an array of berval structures - * returned by a call to ber_scanf with a 'V' in the format string. */ void CDECL ber_bvecfree( BERVAL **berval ) { bvarrayfreeW( berval ); } - /*********************************************************************** * ber_bvfree (WLDAP32.@) - * - * Free a berval structure. - * - * PARAMS - * berval [I] Pointer to a berval structure. - * - * RETURNS - * Nothing. - * - * NOTES - * Use this function only to free berval structures allocated by - * an LDAP API. */ void CDECL ber_bvfree( BERVAL *berval ) { free( berval ); } - /*********************************************************************** * ber_first_element (WLDAP32.@) - * - * Return the tag of the first element in a set or sequence. - * - * PARAMS - * berelement [I] Pointer to a berelement structure. - * len [O] Receives the length of the first element. - * opaque [O] Receives a pointer to a cookie. - * - * RETURNS - * Success: Tag of the first element. - * Failure: LBER_DEFAULT (no more data). - * - * NOTES - * len and cookie should be passed to ber_next_element. */ ULONG CDECL ber_first_element( BerElement *ber, ULONG *len, char **opaque ) { @@ -149,22 +83,8 @@ ULONG CDECL ber_first_element( BerElement *ber, ULONG *len, char **opaque ) return LDAP_CALL( ber_first_element, ¶ms ); } - /*********************************************************************** * ber_flatten (WLDAP32.@) - * - * Flatten a berelement structure into a berval structure. - * - * PARAMS - * berelement [I] Pointer to a berelement structure. - * berval [O] Pointer to a berval structure. - * - * RETURNS - * Success: 0 - * Failure: LBER_ERROR - * - * NOTES - * Free the berval structure with ber_bvfree. */ int CDECL ber_flatten( BerElement *ber, BERVAL **berval ) { @@ -181,22 +101,8 @@ int CDECL ber_flatten( BerElement *ber, BERVAL **berval ) return 0; } - /*********************************************************************** * ber_free (WLDAP32.@) - * - * Free a berelement structure. - * - * PARAMS - * berelement [I] Pointer to the berelement structure to be freed. - * buf [I] Flag. - * - * RETURNS - * Nothing. - * - * NOTES - * Set buf to 0 if the berelement was allocated with ldap_first_attribute - * or ldap_next_attribute, otherwise set it to 1. */ void CDECL ber_free( BerElement *ber, int freebuf ) { @@ -205,21 +111,8 @@ void CDECL ber_free( BerElement *ber, int freebuf ) free( ber ); } - /*********************************************************************** * ber_init (WLDAP32.@) - * - * Initialise a berelement structure from a berval structure. - * - * PARAMS - * berval [I] Pointer to a berval structure. - * - * RETURNS - * Success: Pointer to a berelement structure. - * Failure: NULL - * - * NOTES - * Call ber_free to free the returned berelement structure. */ BerElement * CDECL ber_init( BERVAL *berval ) { @@ -244,24 +137,8 @@ BerElement * CDECL ber_init( BERVAL *berval ) return ret; } - /*********************************************************************** * ber_next_element (WLDAP32.@) - * - * Return the tag of the next element in a set or sequence. - * - * PARAMS - * berelement [I] Pointer to a berelement structure. - * len [I/O] Receives the length of the next element. - * opaque [I/O] Pointer to a cookie. - * - * RETURNS - * Success: Tag of the next element. - * Failure: LBER_DEFAULT (no more data). - * - * NOTES - * len and cookie are initialized by ber_first_element and should - * be passed on in subsequent calls to ber_next_element. */ ULONG CDECL ber_next_element( BerElement *ber, ULONG *len, char *opaque ) { @@ -269,19 +146,8 @@ ULONG CDECL ber_next_element( BerElement *ber, ULONG *len, char *opaque ) return LDAP_CALL( ber_next_element, ¶ms ); } - /*********************************************************************** * ber_peek_tag (WLDAP32.@) - * - * Return the tag of the next element. - * - * PARAMS - * berelement [I] Pointer to a berelement structure. - * len [O] Receives the length of the next element. - * - * RETURNS - * Success: Tag of the next element. - * Failure: LBER_DEFAULT (no more data). */ ULONG CDECL ber_peek_tag( BerElement *ber, ULONG *len ) { @@ -289,19 +155,8 @@ ULONG CDECL ber_peek_tag( BerElement *ber, ULONG *len ) return LDAP_CALL( ber_peek_tag, ¶ms ); } - /*********************************************************************** * ber_skip_tag (WLDAP32.@) - * - * Skip the current tag and return the tag of the next element. - * - * PARAMS - * berelement [I] Pointer to a berelement structure. - * len [O] Receives the length of the skipped element. - * - * RETURNS - * Success: Tag of the next element. - * Failure: LBER_DEFAULT (no more data). */ ULONG CDECL ber_skip_tag( BerElement *ber, ULONG *len ) { @@ -309,24 +164,8 @@ ULONG CDECL ber_skip_tag( BerElement *ber, ULONG *len ) return LDAP_CALL( ber_skip_tag, ¶ms ); } - /*********************************************************************** * ber_printf (WLDAP32.@) - * - * Encode a berelement structure. - * - * PARAMS - * berelement [I/O] Pointer to a berelement structure. - * fmt [I] Format string. - * ... [I] Values to encode. - * - * RETURNS - * Success: Non-negative number. - * Failure: LBER_ERROR - * - * NOTES - * berelement must have been allocated with ber_alloc_t. This function - * can be called multiple times to append data. */ int WINAPIV ber_printf( BerElement *ber, char *fmt, ... ) { @@ -402,24 +241,8 @@ int WINAPIV ber_printf( BerElement *ber, char *fmt, ... ) return ret; } - /*********************************************************************** * ber_scanf (WLDAP32.@) - * - * Decode a berelement structure. - * - * PARAMS - * berelement [I/O] Pointer to a berelement structure. - * fmt [I] Format string. - * ... [I] Pointers to values to be decoded. - * - * RETURNS - * Success: Non-negative number. - * Failure: LBER_ERROR - * - * NOTES - * berelement must have been allocated with ber_init. This function - * can be called multiple times to decode data. */ ULONG WINAPIV ber_scanf( BerElement *ber, char *fmt, ... ) { diff --git a/dlls/wldap32/bind.c b/dlls/wldap32/bind.c index 160a3d1ed30..beb7626b8b1 100644 --- a/dlls/wldap32/bind.c +++ b/dlls/wldap32/bind.c @@ -33,8 +33,6 @@ WINE_DEFAULT_DEBUG_CHANNEL(wldap32); /*********************************************************************** * ldap_bindA (WLDAP32.@) - * - * See ldap_bindW. */ ULONG CDECL ldap_bindA( LDAP *ld, char *dn, char *cred, ULONG method ) { @@ -58,21 +56,6 @@ exit: /*********************************************************************** * ldap_bindW (WLDAP32.@) - * - * Authenticate with an LDAP server (asynchronous operation). - * - * PARAMS - * ld [I] Pointer to an LDAP context. - * dn [I] DN of entry to bind as. - * cred [I] Credentials (e.g. password string). - * method [I] Authentication method. - * - * RETURNS - * Success: Message ID of the bind operation. - * Failure: An LDAP error code. - * - * NOTES - * Only LDAP_AUTH_SIMPLE is supported (just like native). */ ULONG CDECL ldap_bindW( LDAP *ld, WCHAR *dn, WCHAR *cred, ULONG method ) { @@ -111,8 +94,6 @@ exit: /*********************************************************************** * ldap_bind_sA (WLDAP32.@) - * - * See ldap_bind_sW. */ ULONG CDECL ldap_bind_sA( LDAP *ld, char *dn, char *cred, ULONG method ) { @@ -143,18 +124,6 @@ exit: /*********************************************************************** * ldap_bind_sW (WLDAP32.@) - * - * Authenticate with an LDAP server (synchronous operation). - * - * PARAMS - * ld [I] Pointer to an LDAP context. - * dn [I] DN of entry to bind as. - * cred [I] Credentials (e.g. password string). - * method [I] Authentication method. - * - * RETURNS - * Success: LDAP_SUCCESS - * Failure: An LDAP error code. */ ULONG CDECL ldap_bind_sW( LDAP *ld, WCHAR *dn, WCHAR *cred, ULONG method ) { @@ -236,8 +205,6 @@ exit: /*********************************************************************** * ldap_sasl_bindA (WLDAP32.@) - * - * See ldap_sasl_bindW. */ ULONG CDECL ldap_sasl_bindA( LDAP *ld, const PCHAR dn, const PCHAR mechanism, const BERVAL *cred, LDAPControlA **serverctrls, LDAPControlA **clientctrls, int *message ) @@ -268,25 +235,6 @@ exit: /*********************************************************************** * ldap_sasl_bindW (WLDAP32.@) - * - * Authenticate with an LDAP server using SASL (asynchronous operation). - * - * PARAMS - * ld [I] Pointer to an LDAP context. - * dn [I] DN of entry to bind as. - * mechanism [I] Authentication method. - * cred [I] Credentials. - * serverctrls [I] Array of LDAP server controls. - * clientctrls [I] Array of LDAP client controls. - * message [O] Message ID of the bind operation. - * - * RETURNS - * Success: LDAP_SUCCESS - * Failure: An LDAP error code. - * - * NOTES - * The serverctrls and clientctrls parameters are optional and should - * be set to NULL if not used. */ ULONG CDECL ldap_sasl_bindW( LDAP *ld, const PWCHAR dn, const PWCHAR mechanism, const BERVAL *cred, LDAPControlW **serverctrls, LDAPControlW **clientctrls, int *message ) @@ -323,8 +271,6 @@ exit: /*********************************************************************** * ldap_sasl_bind_sA (WLDAP32.@) - * - * See ldap_sasl_bind_sW. */ ULONG CDECL ldap_sasl_bind_sA( LDAP *ld, const PCHAR dn, const PCHAR mechanism, const BERVAL *cred, LDAPControlA **serverctrls, LDAPControlA **clientctrls, BERVAL **serverdata ) @@ -355,25 +301,6 @@ exit: /*********************************************************************** * ldap_sasl_bind_sW (WLDAP32.@) - * - * Authenticate with an LDAP server using SASL (synchronous operation). - * - * PARAMS - * ld [I] Pointer to an LDAP context. - * dn [I] DN of entry to bind as. - * mechanism [I] Authentication method. - * cred [I] Credentials. - * serverctrls [I] Array of LDAP server controls. - * clientctrls [I] Array of LDAP client controls. - * serverdata [O] Authentication response from the server. - * - * RETURNS - * Success: LDAP_SUCCESS - * Failure: An LDAP error code. - * - * NOTES - * The serverctrls and clientctrls parameters are optional and should - * be set to NULL if not used. */ ULONG CDECL ldap_sasl_bind_sW( LDAP *ld, const PWCHAR dn, const PWCHAR mechanism, const BERVAL *cred, LDAPControlW **serverctrls, LDAPControlW **clientctrls, BERVAL **serverdata ) @@ -418,8 +345,6 @@ exit: /*********************************************************************** * ldap_simple_bindA (WLDAP32.@) - * - * See ldap_simple_bindW. */ ULONG CDECL ldap_simple_bindA( LDAP *ld, char *dn, char *passwd ) { @@ -443,20 +368,6 @@ exit: /*********************************************************************** * ldap_simple_bindW (WLDAP32.@) - * - * Authenticate with an LDAP server (asynchronous operation). - * - * PARAMS - * ld [I] Pointer to an LDAP context. - * dn [I] DN of entry to bind as. - * passwd [I] Password string. - * - * RETURNS - * Success: Message ID of the bind operation. - * Failure: An LDAP error code. - * - * NOTES - * Set dn and passwd to NULL to bind as an anonymous user. */ ULONG CDECL ldap_simple_bindW( LDAP *ld, WCHAR *dn, WCHAR *passwd ) { @@ -494,8 +405,6 @@ exit: /*********************************************************************** * ldap_simple_bind_sA (WLDAP32.@) - * - * See ldap_simple_bind_sW. */ ULONG CDECL ldap_simple_bind_sA( LDAP *ld, char *dn, char *passwd ) { @@ -519,20 +428,6 @@ exit: /*********************************************************************** * ldap_simple_bind_sW (WLDAP32.@) - * - * Authenticate with an LDAP server (synchronous operation). - * - * PARAMS - * ld [I] Pointer to an LDAP context. - * dn [I] DN of entry to bind as. - * passwd [I] Password string. - * - * RETURNS - * Success: LDAP_SUCCESS - * Failure: An LDAP error code. - * - * NOTES - * Set dn and passwd to NULL to bind as an anonymous user. */ ULONG CDECL ldap_simple_bind_sW( LDAP *ld, WCHAR *dn, WCHAR *passwd ) { @@ -565,15 +460,6 @@ exit: /*********************************************************************** * ldap_unbind (WLDAP32.@) - * - * Close LDAP connection and free resources (asynchronous operation). - * - * PARAMS - * ld [I] Pointer to an LDAP context. - * - * RETURNS - * Success: LDAP_SUCCESS - * Failure: An LDAP error code. */ ULONG CDECL ldap_unbind( LDAP *ld ) { @@ -596,15 +482,6 @@ ULONG CDECL ldap_unbind( LDAP *ld ) /*********************************************************************** * ldap_unbind_s (WLDAP32.@) - * - * Close LDAP connection and free resources (synchronous operation). - * - * PARAMS - * ld [I] Pointer to an LDAP context. - * - * RETURNS - * Success: LDAP_SUCCESS - * Failure: An LDAP error code. */ ULONG CDECL ldap_unbind_s( LDAP *ld ) { diff --git a/dlls/wldap32/compare.c b/dlls/wldap32/compare.c index 87aa5e388d2..37b87c11c39 100644 --- a/dlls/wldap32/compare.c +++ b/dlls/wldap32/compare.c @@ -31,8 +31,6 @@ WINE_DEFAULT_DEBUG_CHANNEL(wldap32); /*********************************************************************** * ldap_compareA (WLDAP32.@) - * - * See ldap_compareW. */ ULONG CDECL ldap_compareA( LDAP *ld, char *dn, char *attr, char *value ) { @@ -58,18 +56,6 @@ exit: /*********************************************************************** * ldap_compareW (WLDAP32.@) - * - * Check if an attribute has a certain value (asynchronous operation). - * - * PARAMS - * ld [I] Pointer to an LDAP context. - * dn [I] DN of entry to compare value for. - * attr [I] Attribute to compare value for. - * value [I] Value to compare. - * - * RETURNS - * Success: Message ID of the compare operation. - * Failure: An LDAP error code. */ ULONG CDECL ldap_compareW( LDAP *ld, WCHAR *dn, WCHAR *attr, WCHAR *value ) { @@ -84,8 +70,6 @@ ULONG CDECL ldap_compareW( LDAP *ld, WCHAR *dn, WCHAR *attr, WCHAR *value ) /*********************************************************************** * ldap_compare_extA (WLDAP32.@) - * - * See ldap_compare_extW. */ ULONG CDECL ldap_compare_extA( LDAP *ld, char *dn, char *attr, char *value, struct berval *data, LDAPControlA **serverctrls, LDAPControlA **clientctrls, @@ -119,27 +103,6 @@ exit: /*********************************************************************** * ldap_compare_extW (WLDAP32.@) - * - * Check if an attribute has a certain value (asynchronous operation). - * - * PARAMS - * ld [I] Pointer to an LDAP context. - * dn [I] DN of entry to compare value for. - * attr [I] Attribute to compare value for. - * value [I] string encoded value to compare. - * data [I] berval encoded value to compare. - * serverctrls [I] Array of LDAP server controls. - * clientctrls [I] Array of LDAP client controls. - * message [O] Message ID of the compare operation. - * - * RETURNS - * Success: LDAP_SUCCESS - * Failure: An LDAP error code. - * - * NOTES - * Set value to compare strings or data to compare binary values. If - * both are non-NULL, data will be used. The serverctrls and clientctrls - * parameters are optional and should be set to NULL if not used. */ ULONG CDECL ldap_compare_extW( LDAP *ld, WCHAR *dn, WCHAR *attr, WCHAR *value, struct berval *data, LDAPControlW **serverctrls, LDAPControlW **clientctrls, ULONG *message ) @@ -188,8 +151,6 @@ exit: /*********************************************************************** * ldap_compare_ext_sA (WLDAP32.@) - * - * See ldap_compare_ext_sW. */ ULONG CDECL ldap_compare_ext_sA( LDAP *ld, char *dn, char *attr, char *value, struct berval *data, LDAPControlA **serverctrls, LDAPControlA **clientctrls ) @@ -222,26 +183,6 @@ exit: /*********************************************************************** * ldap_compare_ext_sW (WLDAP32.@) - * - * Check if an attribute has a certain value (synchronous operation). - * - * PARAMS - * ld [I] Pointer to an LDAP context. - * dn [I] DN of entry to compare value for. - * attr [I] Attribute to compare value for. - * value [I] string encoded value to compare. - * data [I] berval encoded value to compare. - * serverctrls [I] Array of LDAP server controls. - * clientctrls [I] Array of LDAP client controls. - * - * RETURNS - * Success: LDAP_SUCCESS - * Failure: An LDAP error code. - * - * NOTES - * Set value to compare strings or data to compare binary values. If - * both are non-NULL, data will be used. The serverctrls and clientctrls - * parameters are optional and should be set to NULL if not used. */ ULONG CDECL ldap_compare_ext_sW( LDAP *ld, WCHAR *dn, WCHAR *attr, WCHAR *value, struct berval *data, LDAPControlW **serverctrls, LDAPControlW **clientctrls ) @@ -288,8 +229,6 @@ exit: /*********************************************************************** * ldap_compare_sA (WLDAP32.@) - * - * See ldap_compare_sW. */ ULONG CDECL ldap_compare_sA( LDAP *ld, PCHAR dn, PCHAR attr, PCHAR value ) { @@ -315,18 +254,6 @@ exit: /*********************************************************************** * ldap_compare_sW (WLDAP32.@) - * - * Check if an attribute has a certain value (synchronous operation). - * - * PARAMS - * ld [I] Pointer to an LDAP context. - * dn [I] DN of entry to compare value for. - * attr [I] Attribute to compare value for. - * value [I] Value to compare. - * - * RETURNS - * Success: LDAP_SUCCESS - * Failure: An LDAP error code. */ ULONG CDECL ldap_compare_sW( LDAP *ld, WCHAR *dn, WCHAR *attr, WCHAR *value ) { diff --git a/dlls/wldap32/control.c b/dlls/wldap32/control.c index 9601fb6a96a..a825ada48ce 100644 --- a/dlls/wldap32/control.c +++ b/dlls/wldap32/control.c @@ -31,8 +31,6 @@ WINE_DEFAULT_DEBUG_CHANNEL(wldap32); /*********************************************************************** * ldap_control_freeA (WLDAP32.@) - * - * See ldap_control_freeW. */ ULONG CDECL ldap_control_freeA( LDAPControlA *control ) { @@ -43,14 +41,6 @@ ULONG CDECL ldap_control_freeA( LDAPControlA *control ) /*********************************************************************** * ldap_control_freeW (WLDAP32.@) - * - * Free an LDAPControl structure. - * - * PARAMS - * control [I] LDAPControl structure to free. - * - * RETURNS - * LDAP_SUCCESS */ ULONG CDECL ldap_control_freeW( LDAPControlW *control ) { @@ -61,8 +51,6 @@ ULONG CDECL ldap_control_freeW( LDAPControlW *control ) /*********************************************************************** * ldap_controls_freeA (WLDAP32.@) - * - * See ldap_controls_freeW. */ ULONG CDECL ldap_controls_freeA( LDAPControlA **controls ) { @@ -73,14 +61,6 @@ ULONG CDECL ldap_controls_freeA( LDAPControlA **controls ) /*********************************************************************** * ldap_controls_freeW (WLDAP32.@) - * - * Free an array of LDAPControl structures. - * - * PARAMS - * controls [I] Array of LDAPControl structures to free. - * - * RETURNS - * LDAP_SUCCESS */ ULONG CDECL ldap_controls_freeW( LDAPControlW **controls ) { @@ -91,8 +71,6 @@ ULONG CDECL ldap_controls_freeW( LDAPControlW **controls ) /*********************************************************************** * ldap_create_sort_controlA (WLDAP32.@) - * - * See ldap_create_sort_controlW. */ ULONG CDECL ldap_create_sort_controlA( LDAP *ld, LDAPSortKeyA **sortkey, UCHAR critical, LDAPControlA **control ) { @@ -121,25 +99,6 @@ ULONG CDECL ldap_create_sort_controlA( LDAP *ld, LDAPSortKeyA **sortkey, UCHAR c /*********************************************************************** * ldap_create_sort_controlW (WLDAP32.@) - * - * Create a control for server sorted search results. - * - * PARAMS - * ld [I] Pointer to an LDAP context. - * sortkey [I] Array of LDAPSortKey structures, each specifying an - * attribute to use as a sort key, a matching rule and - * the sort order (ascending or descending). - * critical [I] Tells the server this control is critical to the - * search operation. - * control [O] LDAPControl created. - * - * RETURNS - * Success: LDAP_SUCCESS - * Failure: An LDAP error code. - * - * NOTES - * Pass the created control as a server control in subsequent calls - * to ldap_search_ext(_s) to obtain sorted search results. */ ULONG CDECL ldap_create_sort_controlW( LDAP *ld, LDAPSortKeyW **sortkey, UCHAR critical, LDAPControlW **control ) { @@ -172,8 +131,6 @@ ULONG CDECL ldap_create_sort_controlW( LDAP *ld, LDAPSortKeyW **sortkey, UCHAR c /*********************************************************************** * ldap_create_vlv_controlA (WLDAP32.@) - * - * See ldap_create_vlv_controlW. */ INT CDECL ldap_create_vlv_controlA( LDAP *ld, LDAPVLVInfo *info, UCHAR critical, LDAPControlA **control ) { @@ -198,25 +155,6 @@ INT CDECL ldap_create_vlv_controlA( LDAP *ld, LDAPVLVInfo *info, UCHAR critical, /*********************************************************************** * ldap_create_vlv_controlW (WLDAP32.@) - * - * Create a virtual list view control. - * - * PARAMS - * ld [I] Pointer to an LDAP context. - * info [I] LDAPVLVInfo structure specifying a list view window. - * critical [I] Tells the server this control is critical to the - * search operation. - * control [O] LDAPControl created. - * - * RETURNS - * Success: LDAP_SUCCESS - * Failure: An LDAP error code. - * - * NOTES - * Pass the created control in conjunction with a sort control as - * server controls in subsequent calls to ldap_search_ext(_s). The - * server will then return a sorted, contiguous subset of results - * that meets the criteria specified in the LDAPVLVInfo structure. */ INT CDECL ldap_create_vlv_controlW( LDAP *ld, LDAPVLVInfo *info, UCHAR critical, LDAPControlW **control ) { @@ -259,8 +197,6 @@ static inline void bv_val_dup( const struct berval *src, struct berval *dst ) /*********************************************************************** * ldap_encode_sort_controlA (WLDAP32.@) - * - * See ldap_encode_sort_controlW. */ ULONG CDECL ldap_encode_sort_controlA( LDAP *ld, LDAPSortKeyA **sortkeys, LDAPControlA *ret, BOOLEAN critical ) { @@ -279,25 +215,6 @@ ULONG CDECL ldap_encode_sort_controlA( LDAP *ld, LDAPSortKeyA **sortkeys, LDAPCo /*********************************************************************** * ldap_encode_sort_controlW (WLDAP32.@) - * - * Create a control for server sorted search results. - * - * PARAMS - * ld [I] Pointer to an LDAP context. - * sortkey [I] Array of LDAPSortKey structures, each specifying an - * attribute to use as a sort key, a matching rule and - * the sort order (ascending or descending). - * critical [I] Tells the server this control is critical to the - * search operation. - * control [O] LDAPControl created. - * - * RETURNS - * Success: LDAP_SUCCESS - * Failure: An LDAP error code. - * - * NOTES - * This function is obsolete. Use its equivalent - * ldap_create_sort_control instead. */ ULONG CDECL ldap_encode_sort_controlW( LDAP *ld, LDAPSortKeyW **sortkeys, LDAPControlW *ret, BOOLEAN critical ) { @@ -316,8 +233,6 @@ ULONG CDECL ldap_encode_sort_controlW( LDAP *ld, LDAPSortKeyW **sortkeys, LDAPCo /*********************************************************************** * ldap_free_controlsA (WLDAP32.@) - * - * See ldap_free_controlsW. */ ULONG CDECL ldap_free_controlsA( LDAPControlA **controls ) { @@ -326,17 +241,6 @@ ULONG CDECL ldap_free_controlsA( LDAPControlA **controls ) /*********************************************************************** * ldap_free_controlsW (WLDAP32.@) - * - * Free an array of LDAPControl structures. - * - * PARAMS - * controls [I] Array of LDAPControl structures to free. - * - * RETURNS - * LDAP_SUCCESS - * - * NOTES - * Obsolete, use ldap_controls_freeW. */ ULONG CDECL ldap_free_controlsW( LDAPControlW **controls ) { diff --git a/dlls/wldap32/delete.c b/dlls/wldap32/delete.c index 41f8bfe3921..325aac4a580 100644 --- a/dlls/wldap32/delete.c +++ b/dlls/wldap32/delete.c @@ -31,8 +31,6 @@ WINE_DEFAULT_DEBUG_CHANNEL(wldap32); /*********************************************************************** * ldap_deleteA (WLDAP32.@) - * - * See ldap_deleteW. */ ULONG CDECL ldap_deleteA( LDAP *ld, char *dn ) { @@ -51,21 +49,6 @@ ULONG CDECL ldap_deleteA( LDAP *ld, char *dn ) /*********************************************************************** * ldap_deleteW (WLDAP32.@) - * - * Delete an entry from a directory tree (asynchronous operation). - * - * PARAMS - * ld [I] Pointer to an LDAP context. - * dn [I] DN of the entry to delete. - * - * RETURNS - * Success: Message ID of the add operation. - * Failure: An LDAP error code. - * - * NOTES - * Call ldap_result with the message ID to get the result of - * the operation. Cancel the operation by calling ldap_abandon - * with the message ID. */ ULONG CDECL ldap_deleteW( LDAP *ld, WCHAR *dn ) { @@ -80,8 +63,6 @@ ULONG CDECL ldap_deleteW( LDAP *ld, WCHAR *dn ) /*********************************************************************** * ldap_delete_extA (WLDAP32.@) - * - * See ldap_delete_extW. */ ULONG CDECL ldap_delete_extA( LDAP *ld, char *dn, LDAPControlA **serverctrls, LDAPControlA **clientctrls, ULONG *message ) @@ -109,24 +90,6 @@ exit: /*********************************************************************** * ldap_delete_extW (WLDAP32.@) - * - * Delete an entry from a directory tree (asynchronous operation). - * - * PARAMS - * ld [I] Pointer to an LDAP context. - * dn [I] DN of the entry to delete. - * serverctrls [I] Array of LDAP server controls. - * clientctrls [I] Array of LDAP client controls. - * message [O] Message ID of the delete operation. - * - * RETURNS - * Success: LDAP_SUCCESS - * Failure: An LDAP error code. - * - * NOTES - * Call ldap_result with the message ID to get the result of - * the operation. The serverctrls and clientctrls parameters are - * optional and should be set to NULL if not used. */ ULONG CDECL ldap_delete_extW( LDAP *ld, WCHAR *dn, LDAPControlW **serverctrls, LDAPControlW **clientctrls, ULONG *message ) @@ -157,8 +120,6 @@ exit: /*********************************************************************** * ldap_delete_ext_sA (WLDAP32.@) - * - * See ldap_delete_ext_sW. */ ULONG CDECL ldap_delete_ext_sA( LDAP *ld, char *dn, LDAPControlA **serverctrls, LDAPControlA **clientctrls ) { @@ -185,22 +146,6 @@ exit: /*********************************************************************** * ldap_delete_ext_sW (WLDAP32.@) - * - * Delete an entry from a directory tree (synchronous operation). - * - * PARAMS - * ld [I] Pointer to an LDAP context. - * dn [I] DN of the entry to delete. - * serverctrls [I] Array of LDAP server controls. - * clientctrls [I] Array of LDAP client controls. - * - * RETURNS - * Success: LDAP_SUCCESS - * Failure: An LDAP error code. - * - * NOTES - * The serverctrls and clientctrls parameters are optional and - * should be set to NULL if not used. */ ULONG CDECL ldap_delete_ext_sW( LDAP *ld, WCHAR *dn, LDAPControlW **serverctrls, LDAPControlW **clientctrls ) { @@ -230,8 +175,6 @@ exit: /*********************************************************************** * ldap_delete_sA (WLDAP32.@) - * - * See ldap_delete_sW. */ ULONG CDECL ldap_delete_sA( LDAP *ld, char *dn ) { @@ -250,16 +193,6 @@ ULONG CDECL ldap_delete_sA( LDAP *ld, char *dn ) /*********************************************************************** * ldap_delete_sW (WLDAP32.@) - * - * Delete an entry from a directory tree (synchronous operation). - * - * PARAMS - * ld [I] Pointer to an LDAP context. - * dn [I] DN of the entry to delete. - * - * RETURNS - * Success: LDAP_SUCCESS - * Failure: An LDAP error code. */ ULONG CDECL ldap_delete_sW( LDAP *ld, WCHAR *dn ) { diff --git a/dlls/wldap32/dn.c b/dlls/wldap32/dn.c index d18ff88d9aa..14c4617726a 100644 --- a/dlls/wldap32/dn.c +++ b/dlls/wldap32/dn.c @@ -31,8 +31,6 @@ WINE_DEFAULT_DEBUG_CHANNEL(wldap32); /*********************************************************************** * ldap_dn2ufnA (WLDAP32.@) - * - * See ldap_dn2ufnW. */ char * CDECL ldap_dn2ufnA( char *dn ) { @@ -53,18 +51,6 @@ char * CDECL ldap_dn2ufnA( char *dn ) /*********************************************************************** * ldap_dn2ufnW (WLDAP32.@) - * - * Convert a DN to a user-friendly name. - * - * PARAMS - * dn [I] DN to convert. - * - * RETURNS - * Success: Pointer to a string containing the user-friendly name. - * Failure: NULL - * - * NOTES - * Free the string with ldap_memfree. */ WCHAR * CDECL ldap_dn2ufnW( WCHAR *dn ) { @@ -88,8 +74,6 @@ WCHAR * CDECL ldap_dn2ufnW( WCHAR *dn ) /*********************************************************************** * ldap_explode_dnA (WLDAP32.@) - * - * See ldap_explode_dnW. */ char ** CDECL ldap_explode_dnA( char *dn, ULONG notypes ) { @@ -110,20 +94,6 @@ char ** CDECL ldap_explode_dnA( char *dn, ULONG notypes ) /*********************************************************************** * ldap_explode_dnW (WLDAP32.@) - * - * Break up a DN into its components. - * - * PARAMS - * dn [I] DN to break up. - * notypes [I] Remove attribute type information from the components. - * - * RETURNS - * Success: Pointer to a NULL-terminated array that contains the DN - * components. - * Failure: NULL - * - * NOTES - * Free the string array with ldap_value_free. */ WCHAR ** CDECL ldap_explode_dnW( WCHAR *dn, ULONG notypes ) { @@ -146,8 +116,6 @@ WCHAR ** CDECL ldap_explode_dnW( WCHAR *dn, ULONG notypes ) /*********************************************************************** * ldap_get_dnA (WLDAP32.@) - * - * See ldap_get_dnW. */ char * CDECL ldap_get_dnA( LDAP *ld, LDAPMessage *entry ) { @@ -167,19 +135,6 @@ char * CDECL ldap_get_dnA( LDAP *ld, LDAPMessage *entry ) /*********************************************************************** * ldap_get_dnW (WLDAP32.@) - * - * Retrieve the DN from a given LDAP message. - * - * PARAMS - * ld [I] Pointer to an LDAP context. - * entry [I] LDAPMessage structure to retrieve the DN from. - * - * RETURNS - * Success: Pointer to a string that contains the DN. - * Failure: NULL - * - * NOTES - * Free the string with ldap_memfree. */ WCHAR * CDECL ldap_get_dnW( LDAP *ld, LDAPMessage *entry ) { @@ -201,8 +156,6 @@ WCHAR * CDECL ldap_get_dnW( LDAP *ld, LDAPMessage *entry ) /*********************************************************************** * ldap_ufn2dnA (WLDAP32.@) - * - * See ldap_ufn2dnW. */ ULONG CDECL ldap_ufn2dnA( char *ufn, char **dn ) { @@ -231,19 +184,6 @@ ULONG CDECL ldap_ufn2dnA( char *ufn, char **dn ) /*********************************************************************** * ldap_ufn2dnW (WLDAP32.@) - * - * Convert a user-friendly name to a DN. - * - * PARAMS - * ufn [I] User-friendly name to convert. - * dn [O] Receives a pointer to a string containing the DN. - * - * RETURNS - * Success: LDAP_SUCCESS - * Failure: An LDAP error code. - * - * NOTES - * Free the string with ldap_memfree. */ ULONG CDECL ldap_ufn2dnW( WCHAR *ufn, WCHAR **dn ) { diff --git a/dlls/wldap32/error.c b/dlls/wldap32/error.c index a72babf830d..c2c7a6d9979 100644 --- a/dlls/wldap32/error.c +++ b/dlls/wldap32/error.c @@ -60,8 +60,6 @@ ULONG map_error( int error ) /*********************************************************************** * ldap_err2stringA (WLDAP32.@) - * - * See ldap_err2stringW. */ char * CDECL ldap_err2stringA( ULONG err ) { @@ -79,19 +77,6 @@ char * CDECL ldap_err2stringA( ULONG err ) /*********************************************************************** * ldap_err2stringW (WLDAP32.@) - * - * Convert an error code into a string describing the error. - * - * PARAMS - * err [I] Error code to convert. - * - * RETURNS - * Success: Pointer to a string containing the error description. - * Failure: NULL - * - * NOTES - * The returned string is statically allocated, you must not - * free this string. */ WCHAR * CDECL ldap_err2stringW( ULONG err ) { @@ -109,18 +94,6 @@ WCHAR * CDECL ldap_err2stringW( ULONG err ) /*********************************************************************** * ldap_perror (WLDAP32.@) - * - * Print a given error string. - * - * PARAMS - * ld [I] Pointer to an LDAP context. - * msg [I] Error string. - * - * RETURNS - * Nothing. - * - * NOTES - * Like native, this function does nothing. */ void CDECL ldap_perror( LDAP *ld, const PCHAR msg ) { @@ -129,20 +102,6 @@ void CDECL ldap_perror( LDAP *ld, const PCHAR msg ) /*********************************************************************** * ldap_result2error (WLDAP32.@) - * - * Parse an LDAP message and return the error obtained from it. - * - * PARAMS - * ld [I] Pointer to an LDAP context. - * res [I] Pointer to an LDAPMessage structure. - * free [I] Ask for the LDAPMessage structure to be freed. - * - * RETURNS - * Success: LDAP_SUCCESS - * Failure: An LDAP error code. - * - * NOTES - * If not asked for, use ldap_msgfree to free the LDAPMessage. */ ULONG CDECL ldap_result2error( LDAP *ld, LDAPMessage *res, ULONG free ) { @@ -160,14 +119,6 @@ ULONG CDECL ldap_result2error( LDAP *ld, LDAPMessage *res, ULONG free ) /*********************************************************************** * LdapGetLastError (WLDAP32.@) - * - * Return the last error set by an LDAP function call. - * - * PARAMS - * None. - * - * RETURNS - * An LDAP error code. */ ULONG CDECL LdapGetLastError( void ) { @@ -278,14 +229,6 @@ static const ULONG errormap[] = { /*********************************************************************** * LdapMapErrorToWin32 (WLDAP32.@) - * - * Map an LDAP error code to a Win32 error code. - * - * PARAMS - * err [I] An LDAP error code. - * - * RETURNS - * A Win32 error code. */ ULONG CDECL LdapMapErrorToWin32( ULONG err ) { diff --git a/dlls/wldap32/extended.c b/dlls/wldap32/extended.c index e693ae034f1..8c49c1d6b20 100644 --- a/dlls/wldap32/extended.c +++ b/dlls/wldap32/extended.c @@ -31,20 +31,6 @@ WINE_DEFAULT_DEBUG_CHANNEL(wldap32); /*********************************************************************** * ldap_close_extended_op (WLDAP32.@) - * - * Close an extended operation. - * - * PARAMS - * ld [I] Pointer to an LDAP context. - * msgid [I] Message ID of the operation to be closed. - * - * RETURNS - * Success: LDAP_SUCCESS - * Failure: An LDAP error code. - * - * NOTES - * Contrary to native, OpenLDAP does not require us to close - * extended operations, so this is a no-op. */ ULONG CDECL ldap_close_extended_op( LDAP *ld, ULONG msgid ) { @@ -56,8 +42,6 @@ ULONG CDECL ldap_close_extended_op( LDAP *ld, ULONG msgid ) /*********************************************************************** * ldap_extended_operationA (WLDAP32.@) - * - * See ldap_extended_operationW. */ ULONG CDECL ldap_extended_operationA( LDAP *ld, char *oid, struct berval *data, LDAPControlA **serverctrls, LDAPControlA **clientctrls, ULONG *message ) @@ -85,28 +69,6 @@ exit: /*********************************************************************** * ldap_extended_operationW (WLDAP32.@) - * - * Perform an extended operation (asynchronous mode). - * - * PARAMS - * ld [I] Pointer to an LDAP context. - * oid [I] OID of the extended operation. - * data [I] Data needed by the operation. - * serverctrls [I] Array of LDAP server controls. - * clientctrls [I] Array of LDAP client controls. - * message [O] Message ID of the extended operation. - * - * RETURNS - * Success: LDAP_SUCCESS - * Failure: An LDAP error code. - * - * NOTES - * The data parameter should be set to NULL if the operation - * requires no data. Call ldap_result with the message ID to - * get the result of the operation or ldap_abandon to cancel - * the operation. The serverctrls and clientctrls parameters - * are optional and should be set to NULL if not used. Call - * ldap_close_extended_op to close the operation. */ ULONG CDECL ldap_extended_operationW( LDAP *ld, WCHAR *oid, struct berval *data, LDAPControlW **serverctrls, LDAPControlW **clientctrls, ULONG *message ) @@ -140,8 +102,6 @@ exit: /*********************************************************************** * ldap_extended_operation_sA (WLDAP32.@) - * - * See ldap_extended_operation_sW. */ ULONG CDECL ldap_extended_operation_sA( LDAP *ld, char *oid, struct berval *data, LDAPControlA **serverctrls, LDAPControlA **clientctrls, char **retoid, struct berval **retdata ) @@ -176,27 +136,6 @@ exit: /*********************************************************************** * ldap_extended_operation_sW (WLDAP32.@) - * - * Perform an extended operation (synchronous mode). - * - * PARAMS - * ld [I] Pointer to an LDAP context. - * oid [I] OID of the extended operation. - * data [I] Data needed by the operation. - * serverctrls [I] Array of LDAP server controls. - * clientctrls [I] Array of LDAP client controls. - * retoid [O] OID of the server response message. - * retdata [O] Data returned by the server. - * - * RETURNS - * Success: LDAP_SUCCESS - * Failure: An LDAP error code. - * - * NOTES - * The data parameter should be set to NULL if the operation - * requires no data. The serverctrls, clientctrls, retoid and - * and retdata parameters are also optional. Set to NULL if not - * used. Free retoid and retdata after use with ldap_memfree. */ ULONG CDECL ldap_extended_operation_sW( LDAP *ld, WCHAR *oid, struct berval *data, LDAPControlW **serverctrls, LDAPControlW **clientctrls, WCHAR **retoid, struct berval **retdata ) diff --git a/dlls/wldap32/init.c b/dlls/wldap32/init.c index bd9c8cb4277..c128039bf5c 100644 --- a/dlls/wldap32/init.c +++ b/dlls/wldap32/init.c @@ -212,8 +212,6 @@ static LDAP *create_context( const char *url ) /*********************************************************************** * cldap_openA (WLDAP32.@) - * - * See cldap_openW. */ LDAP * CDECL cldap_openA( char *hostname, ULONG portnumber ) { @@ -232,24 +230,6 @@ LDAP * CDECL cldap_openA( char *hostname, ULONG portnumber ) /*********************************************************************** * cldap_openW (WLDAP32.@) - * - * Initialize an LDAP context and create a UDP connection. - * - * PARAMS - * hostname [I] Name of the host to connect to. - * portnumber [I] Port number to use. - * - * RETURNS - * Success: Pointer to an LDAP context. - * Failure: NULL - * - * NOTES - * The hostname string can be a space separated string of hostnames, - * in which case the LDAP runtime will try to connect to the hosts - * in order, until a connection can be made. A hostname may have a - * trailing port number (separated from the hostname by a ':'), which - * will take precedence over the port number supplied as a parameter - * to this function. */ LDAP * CDECL cldap_openW( WCHAR *hostname, ULONG portnumber ) { @@ -271,21 +251,6 @@ exit: /*********************************************************************** * ldap_connect (WLDAP32.@) - * - * Connect to an LDAP server. - * - * PARAMS - * ld [I] Pointer to an LDAP context. - * timeout [I] Pointer to an l_timeval structure specifying the - * timeout in seconds. - * - * RETURNS - * Success: LDAP_SUCCESS - * Failure: An LDAP error code. - * - * NOTES - * The timeout parameter may be NULL in which case a default timeout - * value will be used. */ ULONG CDECL ldap_connect( LDAP *ld, struct l_timeval *timeout ) { @@ -297,8 +262,6 @@ ULONG CDECL ldap_connect( LDAP *ld, struct l_timeval *timeout ) /*********************************************************************** * ldap_initA (WLDAP32.@) - * - * See ldap_initW. */ LDAP * CDECL ldap_initA( const PCHAR hostname, ULONG portnumber ) { @@ -317,25 +280,6 @@ LDAP * CDECL ldap_initA( const PCHAR hostname, ULONG portnumber ) /*********************************************************************** * ldap_initW (WLDAP32.@) - * - * Initialize an LDAP context and create a TCP connection. - * - * PARAMS - * hostname [I] Name of the host to connect to. - * portnumber [I] Port number to use. - * - * RETURNS - * Success: Pointer to an LDAP context. - * Failure: NULL - * - * NOTES - * The hostname string can be a space separated string of hostnames, - * in which case the LDAP runtime will try to connect to the hosts - * in order, until a connection can be made. A hostname may have a - * trailing port number (separated from the hostname by a ':'), which - * will take precedence over the port number supplied as a parameter - * to this function. The connection will not be made until the first - * LDAP function that needs it is called. */ LDAP * CDECL ldap_initW( const PWCHAR hostname, ULONG portnumber ) { @@ -357,8 +301,6 @@ exit: /*********************************************************************** * ldap_openA (WLDAP32.@) - * - * See ldap_openW. */ LDAP * CDECL ldap_openA( char *hostname, ULONG portnumber ) { @@ -377,24 +319,6 @@ LDAP * CDECL ldap_openA( char *hostname, ULONG portnumber ) /*********************************************************************** * ldap_openW (WLDAP32.@) - * - * Initialize an LDAP context and create a TCP connection. - * - * PARAMS - * hostname [I] Name of the host to connect to. - * portnumber [I] Port number to use. - * - * RETURNS - * Success: Pointer to an LDAP context. - * Failure: NULL - * - * NOTES - * The hostname string can be a space separated string of hostnames, - * in which case the LDAP runtime will try to connect to the hosts - * in order, until a connection can be made. A hostname may have a - * trailing port number (separated from the hostname by a ':'), which - * will take precedence over the port number supplied as a parameter - * to this function. */ LDAP * CDECL ldap_openW( WCHAR *hostname, ULONG portnumber ) { @@ -416,8 +340,6 @@ exit: /*********************************************************************** * ldap_sslinitA (WLDAP32.@) - * - * See ldap_sslinitW. */ LDAP * CDECL ldap_sslinitA( char *hostname, ULONG portnumber, int secure ) { @@ -436,26 +358,6 @@ LDAP * CDECL ldap_sslinitA( char *hostname, ULONG portnumber, int secure ) /*********************************************************************** * ldap_sslinitW (WLDAP32.@) - * - * Initialize an LDAP context and create a secure TCP connection. - * - * PARAMS - * hostname [I] Name of the host to connect to. - * portnumber [I] Port number to use. - * secure [I] Ask the server to create an SSL connection. - * - * RETURNS - * Success: Pointer to an LDAP context. - * Failure: NULL - * - * NOTES - * The hostname string can be a space separated string of hostnames, - * in which case the LDAP runtime will try to connect to the hosts - * in order, until a connection can be made. A hostname may have a - * trailing port number (separated from the hostname by a ':'), which - * will take precedence over the port number supplied as a parameter - * to this function. The connection will not be made until the first - * LDAP function that needs it is called. */ LDAP * CDECL ldap_sslinitW( WCHAR *hostname, ULONG portnumber, int secure ) { @@ -482,8 +384,6 @@ exit: /*********************************************************************** * ldap_start_tls_sA (WLDAP32.@) - * - * See ldap_start_tls_sW. */ ULONG CDECL ldap_start_tls_sA( LDAP *ld, ULONG *retval, LDAPMessage **result, LDAPControlA **serverctrls, LDAPControlA **clientctrls ) @@ -508,22 +408,6 @@ exit: /*********************************************************************** * ldap_start_tls_s (WLDAP32.@) - * - * Start TLS encryption on an LDAP connection. - * - * PARAMS - * ld [I] Pointer to an LDAP context. - * retval [I] Return value from the server. - * result [I] Response message from the server. - * serverctrls [I] Array of LDAP server controls. - * clientctrls [I] Array of LDAP client controls. - * - * RETURNS - * Success: LDAP_SUCCESS - * Failure: An LDAP error code. - * - * NOTES - * LDAP function that needs it is called. */ ULONG CDECL ldap_start_tls_sW( LDAP *ld, ULONG *retval, LDAPMessage **result, LDAPControlW **serverctrls, LDAPControlW **clientctrls ) @@ -565,15 +449,6 @@ ULONG CDECL ldap_startup( LDAP_VERSION_INFO *version, HANDLE *instance ) /*********************************************************************** * ldap_stop_tls_s (WLDAP32.@) - * - * Stop TLS encryption on an LDAP connection. - * - * PARAMS - * ld [I] Pointer to an LDAP context. - * - * RETURNS - * Success: TRUE - * Failure: FALSE */ BOOLEAN CDECL ldap_stop_tls_s( LDAP *ld ) { diff --git a/dlls/wldap32/misc.c b/dlls/wldap32/misc.c index 697f1d3ad5e..135d79a6d58 100644 --- a/dlls/wldap32/misc.c +++ b/dlls/wldap32/misc.c @@ -32,16 +32,6 @@ WINE_DEFAULT_DEBUG_CHANNEL(wldap32); /*********************************************************************** * ldap_abandon (WLDAP32.@) - * - * Cancel an asynchronous operation. - * - * PARAMS - * ld [I] Pointer to an LDAP context. - * msgid [I] ID of the operation to cancel. - * - * RETURNS - * Success: LDAP_SUCCESS - * Failure: An LDAP error code. */ ULONG CDECL ldap_abandon( LDAP *ld, ULONG msgid ) { @@ -57,8 +47,6 @@ ULONG CDECL ldap_abandon( LDAP *ld, ULONG msgid ) /*********************************************************************** * ldap_check_filterA (WLDAP32.@) - * - * See ldap_check_filterW. */ ULONG CDECL ldap_check_filterA( LDAP *ld, char *filter ) { @@ -78,16 +66,6 @@ ULONG CDECL ldap_check_filterA( LDAP *ld, char *filter ) /*********************************************************************** * ldap_check_filterW (WLDAP32.@) - * - * Check filter syntax. - * - * PARAMS - * ld [I] Pointer to an LDAP context. - * filter [I] Filter string. - * - * RETURNS - * Success: LDAP_SUCCESS - * Failure: An LDAP error code. */ ULONG CDECL ldap_check_filterW( LDAP *ld, WCHAR *filter ) { @@ -108,16 +86,6 @@ ULONG CDECL ldap_cleanup( HANDLE instance ) /*********************************************************************** * ldap_conn_from_msg (WLDAP32.@) - * - * Get the LDAP context for a given message. - * - * PARAMS - * ld [I] Pointer to an LDAP context. - * res [I] LDAP message. - * - * RETURNS - * Success: Pointer to an LDAP context. - * Failure: NULL */ LDAP * CDECL ldap_conn_from_msg( LDAP *ld, LDAPMessage *res ) { @@ -129,16 +97,6 @@ LDAP * CDECL ldap_conn_from_msg( LDAP *ld, LDAPMessage *res ) /*********************************************************************** * ldap_count_entries (WLDAP32.@) - * - * Count the number of entries returned from a search. - * - * PARAMS - * ld [I] Pointer to an LDAP context. - * res [I] LDAP message. - * - * RETURNS - * Success: The number of entries. - * Failure: ~0u */ ULONG CDECL ldap_count_entries( LDAP *ld, LDAPMessage *res ) { @@ -154,16 +112,6 @@ ULONG CDECL ldap_count_entries( LDAP *ld, LDAPMessage *res ) /*********************************************************************** * ldap_count_references (WLDAP32.@) - * - * Count the number of references returned from a search. - * - * PARAMS - * ld [I] Pointer to an LDAP context. - * res [I] LDAP message. - * - * RETURNS - * Success: The number of references. - * Failure: ~0u */ ULONG CDECL ldap_count_references( LDAP *ld, LDAPMessage *res ) { @@ -216,8 +164,6 @@ static void escape_filter_element( char *src, ULONG srclen, char *dst ) /*********************************************************************** * ldap_escape_filter_elementA (WLDAP32.@) - * - * See ldap_escape_filter_elementW. */ ULONG CDECL ldap_escape_filter_elementA( char *src, ULONG srclen, char *dst, ULONG dstlen ) { @@ -234,18 +180,6 @@ ULONG CDECL ldap_escape_filter_elementA( char *src, ULONG srclen, char *dst, ULO /*********************************************************************** * ldap_escape_filter_elementW (WLDAP32.@) - * - * Escape binary data for safe passing in filters. - * - * PARAMS - * src [I] Filter element to be escaped. - * srclen [I] Length in bytes of the filter element. - * dst [O] Destination buffer for the escaped filter element. - * dstlen [I] Length in bytes of the destination buffer. - * - * RETURNS - * Success: LDAP_SUCCESS - * Failure: An LDAP error code. */ ULONG CDECL ldap_escape_filter_elementW( char *src, ULONG srclen, WCHAR *dst, ULONG dstlen ) { @@ -261,8 +195,6 @@ ULONG CDECL ldap_escape_filter_elementW( char *src, ULONG srclen, WCHAR *dst, UL /*********************************************************************** * ldap_first_attributeA (WLDAP32.@) - * - * See ldap_first_attributeW. */ char * CDECL ldap_first_attributeA( LDAP *ld, LDAPMessage *entry, BerElement **ber ) { @@ -285,20 +217,6 @@ char * CDECL ldap_first_attributeA( LDAP *ld, LDAPMessage *entry, BerElement **b /*********************************************************************** * ldap_first_attributeW (WLDAP32.@) - * - * Get the first attribute for a given entry. - * - * PARAMS - * ld [I] Pointer to an LDAP context. - * entry [I] Entry to retrieve attribute for. - * ptr [O] Position pointer. - * - * RETURNS - * Success: Name of the first attribute. - * Failure: NULL - * - * NOTES - * Use ldap_memfree to free the returned string. */ WCHAR * CDECL ldap_first_attributeW( LDAP *ld, LDAPMessage *entry, BerElement **ptr ) { @@ -329,19 +247,6 @@ WCHAR * CDECL ldap_first_attributeW( LDAP *ld, LDAPMessage *entry, BerElement ** /*********************************************************************** * ldap_first_entry (WLDAP32.@) - * - * Get the first entry from a result message. - * - * PARAMS - * ld [I] Pointer to an LDAP context. - * res [I] Search result message. - * - * RETURNS - * Success: The first entry. - * Failure: NULL - * - * NOTES - * The returned entry will be freed when the message is freed. */ LDAPMessage * CDECL ldap_first_entry( LDAP *ld, LDAPMessage *res ) { @@ -363,16 +268,6 @@ LDAPMessage * CDECL ldap_first_entry( LDAP *ld, LDAPMessage *res ) /*********************************************************************** * ldap_first_reference (WLDAP32.@) - * - * Get the first reference from a result message. - * - * PARAMS - * ld [I] Pointer to an LDAP context. - * res [I] Search result message. - * - * RETURNS - * Success: The first reference. - * Failure: NULL */ LDAPMessage * CDECL ldap_first_reference( LDAP *ld, LDAPMessage *res ) { @@ -394,8 +289,6 @@ LDAPMessage * CDECL ldap_first_reference( LDAP *ld, LDAPMessage *res ) /*********************************************************************** * ldap_memfreeA (WLDAP32.@) - * - * See ldap_memfreeW. */ void CDECL ldap_memfreeA( char *block ) { @@ -405,11 +298,6 @@ void CDECL ldap_memfreeA( char *block ) /*********************************************************************** * ldap_memfreeW (WLDAP32.@) - * - * Free a block of memory. - * - * PARAMS - * block [I] Pointer to memory block to be freed. */ void CDECL ldap_memfreeW( WCHAR *block ) { @@ -419,11 +307,6 @@ void CDECL ldap_memfreeW( WCHAR *block ) /*********************************************************************** * ldap_msgfree (WLDAP32.@) - * - * Free a message. - * - * PARAMS - * res [I] Message to be freed. */ ULONG CDECL ldap_msgfree( LDAPMessage *res ) { @@ -446,8 +329,6 @@ ULONG CDECL ldap_msgfree( LDAPMessage *res ) /*********************************************************************** * ldap_next_attributeA (WLDAP32.@) - * - * See ldap_next_attributeW. */ char * CDECL ldap_next_attributeA( LDAP *ld, LDAPMessage *entry, BerElement *ptr ) { @@ -470,21 +351,6 @@ char * CDECL ldap_next_attributeA( LDAP *ld, LDAPMessage *entry, BerElement *ptr /*********************************************************************** * ldap_next_attributeW (WLDAP32.@) - * - * Get the next attribute for a given entry. - * - * PARAMS - * ld [I] Pointer to an LDAP context. - * entry [I] Entry to retrieve attribute for. - * ptr [I/O] Position pointer. - * - * RETURNS - * Success: The name of the next attribute. - * Failure: NULL - * - * NOTES - * Free the returned string after each iteration with ldap_memfree. - * When done iterating and when ptr != NULL, call ber_free( ptr, 0 ). */ WCHAR * CDECL ldap_next_attributeW( LDAP *ld, LDAPMessage *entry, BerElement *ptr ) { @@ -507,19 +373,6 @@ WCHAR * CDECL ldap_next_attributeW( LDAP *ld, LDAPMessage *entry, BerElement *pt /*********************************************************************** * ldap_next_entry (WLDAP32.@) - * - * Get the next entry from a result message. - * - * PARAMS - * ld [I] Pointer to an LDAP context. - * entry [I] Entry returned by a previous call. - * - * RETURNS - * Success: The next entry. - * Failure: NULL - * - * NOTES - * The returned entry will be freed when the message is freed. */ LDAPMessage * CDECL ldap_next_entry( LDAP *ld, LDAPMessage *entry ) { @@ -548,19 +401,6 @@ LDAPMessage * CDECL ldap_next_entry( LDAP *ld, LDAPMessage *entry ) /*********************************************************************** * ldap_next_reference (WLDAP32.@) - * - * Get the next reference from a result message. - * - * PARAMS - * ld [I] Pointer to an LDAP context. - * entry [I] Entry returned by a previous call. - * - * RETURNS - * Success: The next reference. - * Failure: NULL - * - * NOTES - * The returned entry will be freed when the message is freed. */ LDAPMessage * CDECL ldap_next_reference( LDAP *ld, LDAPMessage *entry ) { @@ -588,39 +428,6 @@ LDAPMessage * CDECL ldap_next_reference( LDAP *ld, LDAPMessage *entry ) /*********************************************************************** * ldap_result (WLDAP32.@) - * - * Get the result of an asynchronous operation. - * - * PARAMS - * ld [I] Pointer to an LDAP context. - * msgid [I] Message ID of the operation. - * all [I] How many results should be returned? - * timeout [I] How long to wait for the results? - * res [O] Result message for the operation. - * - * RETURNS - * Success: One of the following values: - * - * LDAP_RES_ADD - * LDAP_RES_BIND - * LDAP_RES_COMPARE - * LDAP_RES_DELETE - * LDAP_RES_EXTENDED - * LDAP_RES_MODIFY - * LDAP_RES_MODRDN - * LDAP_RES_REFERRAL - * LDAP_RES_SEARCH_ENTRY - * LDAP_RES_SEARCH_RESULT - * - * Failure: ~0u - * - * This function returns 0 when the timeout has expired. - * - * NOTES - * A NULL timeout pointer causes the function to block waiting - * for results to arrive. A timeout value of 0 causes the function - * to immediately return any available results. Free returned results - * with ldap_msgfree. */ ULONG CDECL ldap_result( LDAP *ld, ULONG msgid, ULONG all, struct l_timeval *timeout, LDAPMessage **res ) { @@ -654,20 +461,6 @@ ULONG CDECL ldap_result( LDAP *ld, ULONG msgid, ULONG all, struct l_timeval *tim /*********************************************************************** * LdapUnicodeToUTF8 (WLDAP32.@) - * - * Convert a wide character string to a UTF8 string. - * - * PARAMS - * src [I] Wide character string to convert. - * srclen [I] Size of string to convert, in characters. - * dst [O] Pointer to a buffer that receives the converted string. - * dstlen [I] Size of the destination buffer in characters. - * - * RETURNS - * The number of characters written into the destination buffer. - * - * NOTES - * Set dstlen to zero to ask for the required buffer size. */ int CDECL LdapUnicodeToUTF8( const WCHAR *src, int srclen, char *dst, int dstlen ) { @@ -676,20 +469,6 @@ int CDECL LdapUnicodeToUTF8( const WCHAR *src, int srclen, char *dst, int dstlen /*********************************************************************** * LdapUTF8ToUnicode (WLDAP32.@) - * - * Convert a UTF8 string to a wide character string. - * - * PARAMS - * src [I] UTF8 string to convert. - * srclen [I] Size of string to convert, in characters. - * dst [O] Pointer to a buffer that receives the converted string. - * dstlen [I] Size of the destination buffer in characters. - * - * RETURNS - * The number of characters written into the destination buffer. - * - * NOTES - * Set dstlen to zero to ask for the required buffer size. */ int CDECL LdapUTF8ToUnicode( const char *src, int srclen, WCHAR *dst, int dstlen ) { diff --git a/dlls/wldap32/modify.c b/dlls/wldap32/modify.c index 7c7f2c61293..553437a0b22 100644 --- a/dlls/wldap32/modify.c +++ b/dlls/wldap32/modify.c @@ -31,8 +31,6 @@ WINE_DEFAULT_DEBUG_CHANNEL(wldap32); /*********************************************************************** * ldap_modifyA (WLDAP32.@) - * - * See ldap_modifyW. */ ULONG CDECL ldap_modifyA( LDAP *ld, char *dn, LDAPModA **mods ) { @@ -57,23 +55,6 @@ exit: /*********************************************************************** * ldap_modifyW (WLDAP32.@) - * - * Change an entry in a directory tree (asynchronous operation). - * - * PARAMS - * ld [I] Pointer to an LDAP context. - * dn [I] DN of the entry to change. - * mods [I] Pointer to an array of LDAPModW structures, each - * specifying an attribute and its values to change. - * - * RETURNS - * Success: Message ID of the modify operation. - * Failure: An LDAP error code. - * - * NOTES - * Call ldap_result with the message ID to get the result of - * the operation. Cancel the operation by calling ldap_abandon - * with the message ID. */ ULONG CDECL ldap_modifyW( LDAP *ld, WCHAR *dn, LDAPModW **mods ) { @@ -88,8 +69,6 @@ ULONG CDECL ldap_modifyW( LDAP *ld, WCHAR *dn, LDAPModW **mods ) /*********************************************************************** * ldap_modify_extA (WLDAP32.@) - * - * See ldap_modify_extW. */ ULONG CDECL ldap_modify_extA( LDAP *ld, char *dn, LDAPModA **mods, LDAPControlA **serverctrls, LDAPControlA **clientctrls, ULONG *message ) @@ -120,26 +99,6 @@ exit: /*********************************************************************** * ldap_modify_extW (WLDAP32.@) - * - * Change an entry in a directory tree (asynchronous operation). - * - * PARAMS - * ld [I] Pointer to an LDAP context. - * dn [I] DN of the entry to change. - * mods [I] Pointer to an array of LDAPModW structures, each - * specifying an attribute and its values to change. - * serverctrls [I] Array of LDAP server controls. - * clientctrls [I] Array of LDAP client controls. - * message [O] Message ID of the modify operation. - * - * RETURNS - * Success: LDAP_SUCCESS - * Failure: An LDAP error code. - * - * NOTES - * Call ldap_result with the message ID to get the result of - * the operation. The serverctrls and clientctrls parameters are - * optional and should be set to NULL if not used. */ ULONG CDECL ldap_modify_extW( LDAP *ld, WCHAR *dn, LDAPModW **mods, LDAPControlW **serverctrls, LDAPControlW **clientctrls, ULONG *message ) @@ -173,8 +132,6 @@ exit: /*********************************************************************** * ldap_modify_ext_sA (WLDAP32.@) - * - * See ldap_modify_ext_sW. */ ULONG CDECL ldap_modify_ext_sA( LDAP *ld, char *dn, LDAPModA **mods, LDAPControlA **serverctrls, LDAPControlA **clientctrls ) @@ -205,24 +162,6 @@ exit: /*********************************************************************** * ldap_modify_ext_sW (WLDAP32.@) - * - * Change an entry in a directory tree (synchronous operation). - * - * PARAMS - * ld [I] Pointer to an LDAP context. - * dn [I] DN of the entry to change. - * mods [I] Pointer to an array of LDAPModW structures, each - * specifying an attribute and its values to change. - * serverctrls [I] Array of LDAP server controls. - * clientctrls [I] Array of LDAP client controls. - * - * RETURNS - * Success: LDAP_SUCCESS - * Failure: An LDAP error code. - * - * NOTES - * The serverctrls and clientctrls parameters are optional and - * should be set to NULL if not used. */ ULONG CDECL ldap_modify_ext_sW( LDAP *ld, WCHAR *dn, LDAPModW **mods, LDAPControlW **serverctrls, LDAPControlW **clientctrls ) @@ -256,8 +195,6 @@ exit: /*********************************************************************** * ldap_modify_sA (WLDAP32.@) - * - * See ldap_modify_sW. */ ULONG CDECL ldap_modify_sA( LDAP *ld, char *dn, LDAPModA **mods ) { @@ -282,18 +219,6 @@ exit: /*********************************************************************** * ldap_modify_sW (WLDAP32.@) - * - * Change an entry in a directory tree (synchronous operation). - * - * PARAMS - * ld [I] Pointer to an LDAP context. - * dn [I] DN of the entry to change. - * attrs [I] Pointer to an array of LDAPModW structures, each - * specifying an attribute and its values to change. - * - * RETURNS - * Success: LDAP_SUCCESS - * Failure: An LDAP error code. */ ULONG CDECL ldap_modify_sW( LDAP *ld, WCHAR *dn, LDAPModW **mods ) { diff --git a/dlls/wldap32/modrdn.c b/dlls/wldap32/modrdn.c index 97e06a1975c..999e5b5df62 100644 --- a/dlls/wldap32/modrdn.c +++ b/dlls/wldap32/modrdn.c @@ -31,8 +31,6 @@ WINE_DEFAULT_DEBUG_CHANNEL(wldap32); /*********************************************************************** * ldap_modrdnA (WLDAP32.@) - * - * See ldap_modrdnW. */ ULONG CDECL ldap_modrdnA( LDAP *ld, char *dn, char *newdn ) { @@ -56,22 +54,6 @@ exit: /*********************************************************************** * ldap_modrdnW (WLDAP32.@) - * - * Change the RDN of a directory entry (asynchronous operation). - * - * PARAMS - * ld [I] Pointer to an LDAP context. - * dn [I] DN of the entry to change. - * newdn [I] New DN for the entry. - * - * RETURNS - * Success: Message ID of the modrdn operation. - * Failure: An LDAP error code. - * - * NOTES - * Call ldap_result with the message ID to get the result of - * the operation. Cancel the operation by calling ldap_abandon - * with the message ID. */ ULONG CDECL ldap_modrdnW( LDAP *ld, WCHAR *dn, WCHAR *newdn ) { @@ -81,8 +63,6 @@ ULONG CDECL ldap_modrdnW( LDAP *ld, WCHAR *dn, WCHAR *newdn ) /*********************************************************************** * ldap_modrdn2A (WLDAP32.@) - * - * See ldap_modrdn2W. */ ULONG CDECL ldap_modrdn2A( LDAP *ld, char *dn, char *newdn, int delete ) { @@ -106,23 +86,6 @@ exit: /*********************************************************************** * ldap_modrdn2W (WLDAP32.@) - * - * Change the RDN of a directory entry (asynchronous operation). - * - * PARAMS - * ld [I] Pointer to an LDAP context. - * dn [I] DN of the entry to change. - * newdn [I] New DN for the entry. - * delete [I] Delete old DN? - * - * RETURNS - * Success: Message ID of the modrdn operation. - * Failure: An LDAP error code. - * - * NOTES - * Call ldap_result with the message ID to get the result of - * the operation. Cancel the operation by calling ldap_abandon - * with the message ID. */ ULONG CDECL ldap_modrdn2W( LDAP *ld, WCHAR *dn, WCHAR *newdn, int delete ) { @@ -152,8 +115,6 @@ ULONG CDECL ldap_modrdn2W( LDAP *ld, WCHAR *dn, WCHAR *newdn, int delete ) /*********************************************************************** * ldap_modrdn2_sA (WLDAP32.@) - * - * See ldap_modrdn2_sW. */ ULONG CDECL ldap_modrdn2_sA( LDAP *ld, char *dn, char *newdn, int delete ) { @@ -177,18 +138,6 @@ exit: /*********************************************************************** * ldap_modrdn2_sW (WLDAP32.@) - * - * Change the RDN of a directory entry (synchronous operation). - * - * PARAMS - * ld [I] Pointer to an LDAP context. - * dn [I] DN of the entry to change. - * newdn [I] New DN for the entry. - * delete [I] Delete old DN? - * - * RETURNS - * Success: LDAP_SUCCESS - * Failure: An LDAP error code. */ ULONG CDECL ldap_modrdn2_sW( LDAP *ld, WCHAR *dn, WCHAR *newdn, int delete ) { @@ -213,8 +162,6 @@ ULONG CDECL ldap_modrdn2_sW( LDAP *ld, WCHAR *dn, WCHAR *newdn, int delete ) /*********************************************************************** * ldap_modrdn_sA (WLDAP32.@) - * - * See ldap_modrdn_sW. */ ULONG CDECL ldap_modrdn_sA( LDAP *ld, char *dn, char *newdn ) { @@ -238,17 +185,6 @@ exit: /*********************************************************************** * ldap_modrdn_sW (WLDAP32.@) - * - * Change the RDN of a directory entry (synchronous operation). - * - * PARAMS - * ld [I] Pointer to an LDAP context. - * dn [I] DN of the entry to change. - * newdn [I] New DN for the entry. - * - * RETURNS - * Success: LDAP_SUCCESS - * Failure: An LDAP error code. */ ULONG CDECL ldap_modrdn_sW( LDAP *ld, WCHAR *dn, WCHAR *newdn ) { diff --git a/dlls/wldap32/option.c b/dlls/wldap32/option.c index efd0d4586b9..d848522fa56 100644 --- a/dlls/wldap32/option.c +++ b/dlls/wldap32/option.c @@ -35,8 +35,6 @@ WINE_DEFAULT_DEBUG_CHANNEL(wldap32); /*********************************************************************** * ldap_get_optionA (WLDAP32.@) - * - * See ldap_get_optionW. */ ULONG CDECL ldap_get_optionA( LDAP *ld, int option, void *value ) { @@ -154,17 +152,6 @@ ULONG CDECL ldap_get_optionA( LDAP *ld, int option, void *value ) /*********************************************************************** * ldap_get_optionW (WLDAP32.@) - * - * Retrieve option values for a given LDAP context. - * - * PARAMS - * ld [I] Pointer to an LDAP context. - * option [I] Option to get values for. - * value [O] Pointer to option values. - * - * RETURNS - * Success: LDAP_SUCCESS - * Failure: An LDAP error code. */ ULONG CDECL ldap_get_optionW( LDAP *ld, int option, void *value ) { @@ -289,8 +276,6 @@ ULONG CDECL ldap_get_optionW( LDAP *ld, int option, void *value ) /*********************************************************************** * ldap_set_optionA (WLDAP32.@) - * - * See ldap_set_optionW. */ ULONG CDECL ldap_set_optionA( LDAP *ld, int option, void *value ) { @@ -435,20 +420,6 @@ static BOOL is_supported_server_ctrls( LDAP *ld, LDAPControlU **ctrls ) /*********************************************************************** * ldap_set_optionW (WLDAP32.@) - * - * Set option values for a given LDAP context. - * - * PARAMS - * ld [I] Pointer to an LDAP context. - * option [I] Option to set values for. - * value [I] Pointer to option values. - * - * RETURNS - * Success: LDAP_SUCCESS - * Failure: An LDAP error code. - * - * NOTES - * Set value to LDAP_OPT_ON or LDAP_OPT_OFF for on/off options. */ ULONG CDECL ldap_set_optionW( LDAP *ld, int option, void *value ) { diff --git a/dlls/wldap32/page.c b/dlls/wldap32/page.c index e36d0ad5615..fab2b83366a 100644 --- a/dlls/wldap32/page.c +++ b/dlls/wldap32/page.c @@ -36,8 +36,6 @@ static struct berval null_cookieW = { 0, NULL }; /*********************************************************************** * ldap_create_page_controlA (WLDAP32.@) - * - * See ldap_create_page_controlW. */ ULONG CDECL ldap_create_page_controlA( LDAP *ld, ULONG pagesize, struct berval *cookie, UCHAR critical, LDAPControlA **control ) @@ -110,21 +108,6 @@ static ULONG create_page_control( ULONG pagesize, struct berval *cookie, UCHAR c /*********************************************************************** * ldap_create_page_controlW (WLDAP32.@) - * - * Create a control for paged search results. - * - * PARAMS - * ld [I] Pointer to an LDAP context. - * pagesize [I] Number of entries to return per page. - * cookie [I] Used by the server to track its location in the - * search results. - * critical [I] Tells the server this control is critical to the - * search operation. - * control [O] LDAPControl created. - * - * RETURNS - * Success: LDAP_SUCCESS - * Failure: An LDAP error code. */ ULONG CDECL ldap_create_page_controlW( LDAP *ld, ULONG pagesize, struct berval *cookie, UCHAR critical, LDAPControlW **control ) diff --git a/dlls/wldap32/parse.c b/dlls/wldap32/parse.c index 88e801b3053..bcd0e61607a 100644 --- a/dlls/wldap32/parse.c +++ b/dlls/wldap32/parse.c @@ -31,8 +31,6 @@ WINE_DEFAULT_DEBUG_CHANNEL(wldap32); /*********************************************************************** * ldap_parse_extended_resultA (WLDAP32.@) - * - * See ldap_parse_extended_resultW. */ ULONG CDECL ldap_parse_extended_resultA( LDAP *ld, LDAPMessage *result, char **oid, struct berval **data, BOOLEAN free ) @@ -58,23 +56,6 @@ ULONG CDECL ldap_parse_extended_resultA( LDAP *ld, LDAPMessage *result, char **o /*********************************************************************** * ldap_parse_extended_resultW (WLDAP32.@) - * - * Parse the result of an extended operation. - * - * PARAMS - * ld [I] Pointer to an LDAP context. - * result [I] Result message from an extended operation. - * oid [O] OID of the extended operation. - * data [O] Result data. - * free [I] Free the result message? - * - * RETURNS - * Success: LDAP_SUCCESS - * Failure: An LDAP error code. - * - * NOTES - * Free the OID and result data with ldap_memfree. Pass a nonzero - * value for 'free' or call ldap_msgfree to free the result message. */ ULONG CDECL ldap_parse_extended_resultW( LDAP *ld, LDAPMessage *result, WCHAR **oid, struct berval **data, BOOLEAN free ) @@ -112,8 +93,6 @@ ULONG CDECL ldap_parse_extended_resultW( LDAP *ld, LDAPMessage *result, WCHAR ** /*********************************************************************** * ldap_parse_referenceA (WLDAP32.@) - * - * See ldap_parse_referenceW. */ ULONG CDECL ldap_parse_referenceA( LDAP *ld, LDAPMessage *message, char ***referrals ) { @@ -137,20 +116,6 @@ ULONG CDECL ldap_parse_referenceA( LDAP *ld, LDAPMessage *message, char ***refer /*********************************************************************** * ldap_parse_referenceW (WLDAP32.@) - * - * Return any referrals from a result message. - * - * PARAMS - * ld [I] Pointer to an LDAP context. - * result [I] Result message. - * referrals [O] Array of referral URLs. - * - * RETURNS - * Success: LDAP_SUCCESS - * Failure: An LDAP error code. - * - * NOTES - * Free the referrals with ldap_value_free. */ ULONG CDECL ldap_parse_referenceW( LDAP *ld, LDAPMessage *message, WCHAR ***referrals ) { @@ -176,8 +141,6 @@ ULONG CDECL ldap_parse_referenceW( LDAP *ld, LDAPMessage *message, WCHAR ***refe /*********************************************************************** * ldap_parse_resultA (WLDAP32.@) - * - * See ldap_parse_resultW. */ ULONG CDECL ldap_parse_resultA( LDAP *ld, LDAPMessage *result, ULONG *retcode, char **matched, char **error, char ***referrals, LDAPControlA ***serverctrls, BOOLEAN free ) @@ -207,28 +170,6 @@ ULONG CDECL ldap_parse_resultA( LDAP *ld, LDAPMessage *result, ULONG *retcode, c /*********************************************************************** * ldap_parse_resultW (WLDAP32.@) - * - * Parse a result message. - * - * PARAMS - * ld [I] Pointer to an LDAP context. - * result [I] Result message. - * retcode [O] Return code for the server operation. - * matched [O] DNs matched in the operation. - * error [O] Error message for the operation. - * referrals [O] Referrals found in the result message. - * serverctrls [O] Controls used in the operation. - * free [I] Free the result message? - * - * RETURNS - * Success: LDAP_SUCCESS - * Failure: An LDAP error code. - * - * NOTES - * Free the DNs and error message with ldap_memfree. Free - * the referrals with ldap_value_free and the controls with - * ldap_controls_free. Pass a nonzero value for 'free' or call - * ldap_msgfree to free the result message. */ ULONG CDECL ldap_parse_resultW( LDAP *ld, LDAPMessage *result, ULONG *retcode, WCHAR **matched, WCHAR **error, WCHAR ***referrals, LDAPControlW ***serverctrls, BOOLEAN free ) @@ -262,8 +203,6 @@ ULONG CDECL ldap_parse_resultW( LDAP *ld, LDAPMessage *result, ULONG *retcode, W /*********************************************************************** * ldap_parse_sort_controlA (WLDAP32.@) - * - * See ldap_parse_sort_controlW. */ ULONG CDECL ldap_parse_sort_controlA( LDAP *ld, LDAPControlA **control, ULONG *result, char **attr ) { @@ -286,21 +225,6 @@ ULONG CDECL ldap_parse_sort_controlA( LDAP *ld, LDAPControlA **control, ULONG *r /*********************************************************************** * ldap_parse_sort_controlW (WLDAP32.@) - * - * Parse a sort control. - * - * PARAMS - * ld [I] Pointer to an LDAP context. - * control [I] Control obtained from a result message. - * result [O] Result code. - * attr [O] Failing attribute. - * - * RETURNS - * Success: LDAP_SUCCESS - * Failure: An LDAP error code. - * - * NOTES - * If the function fails, free the failing attribute with ldap_memfree. */ ULONG CDECL ldap_parse_sort_controlW( LDAP *ld, LDAPControlW **control, ULONG *result, WCHAR **attr ) { @@ -349,8 +273,6 @@ ULONG CDECL ldap_parse_sort_controlW( LDAP *ld, LDAPControlW **control, ULONG *r /*********************************************************************** * ldap_parse_vlv_controlA (WLDAP32.@) - * - * See ldap_parse_vlv_controlW. */ int CDECL ldap_parse_vlv_controlA( LDAP *ld, LDAPControlA **control, ULONG *targetpos, ULONG *listcount, struct berval **context, int *errcode ) @@ -370,23 +292,6 @@ int CDECL ldap_parse_vlv_controlA( LDAP *ld, LDAPControlA **control, ULONG *targ /*********************************************************************** * ldap_parse_vlv_controlW (WLDAP32.@) - * - * Parse a virtual list view control. - * - * PARAMS - * ld [I] Pointer to an LDAP context. - * control [I] Controls obtained from a result message. - * targetpos [O] Position of the target in the result list. - * listcount [O] Estimate of the number of results in the list. - * context [O] Server side context. - * errcode [O] Error code from the listview operation. - * - * RETURNS - * Success: LDAP_SUCCESS - * Failure: An LDAP error code. - * - * NOTES - * Free the server context with ber_bvfree. */ int CDECL ldap_parse_vlv_controlW( LDAP *ld, LDAPControlW **control, ULONG *targetpos, ULONG *listcount, struct berval **context, int *errcode ) diff --git a/dlls/wldap32/rename.c b/dlls/wldap32/rename.c index f6b343521c5..58a2f2101b3 100644 --- a/dlls/wldap32/rename.c +++ b/dlls/wldap32/rename.c @@ -31,8 +31,6 @@ WINE_DEFAULT_DEBUG_CHANNEL(wldap32); /*********************************************************************** * ldap_rename_extA (WLDAP32.@) - * - * See ldap_rename_extW. */ ULONG CDECL ldap_rename_extA( LDAP *ld, char *dn, char *newrdn, char *newparent, int delete, LDAPControlA **serverctrls, LDAPControlA **clientctrls, ULONG *message ) @@ -65,27 +63,6 @@ exit: /*********************************************************************** * ldap_rename_extW (WLDAP32.@) - * - * Change the DN of a directory entry (asynchronous operation). - * - * PARAMS - * ld [I] Pointer to an LDAP context. - * dn [I] DN of the entry to change. - * newrdn [I] New RDN for the entry. - * newparent [I] New parent for the entry. - * delete [I] Delete old RDN? - * serverctrls [I] Array of LDAP server controls. - * clientctrls [I] Array of LDAP client controls. - * message [O] Message ID of the operation. - * - * RETURNS - * Success: LDAP_SUCCESS - * Failure: An LDAP error code. - * - * NOTES - * Call ldap_result with the message ID to get the result of - * the operation. Cancel the operation by calling ldap_abandon - * with the message ID. */ ULONG CDECL ldap_rename_extW( LDAP *ld, WCHAR *dn, WCHAR *newrdn, WCHAR *newparent, int delete, LDAPControlW **serverctrls, LDAPControlW **clientctrls, ULONG *message ) @@ -120,8 +97,6 @@ exit: /*********************************************************************** * ldap_rename_ext_sA (WLDAP32.@) - * - * See ldap_rename_ext_sW. */ ULONG CDECL ldap_rename_ext_sA( LDAP *ld, char *dn, char *newrdn, char *newparent, int delete, LDAPControlA **serverctrls, LDAPControlA **clientctrls ) @@ -151,23 +126,9 @@ exit: controlarrayfreeW( clientctrlsW ); return ret; } + /*********************************************************************** * ldap_rename_ext_sW (WLDAP32.@) - * - * Change the DN of a directory entry (synchronous operation). - * - * PARAMS - * ld [I] Pointer to an LDAP context. - * dn [I] DN of the entry to change. - * newrdn [I] New RDN for the entry. - * newparent [I] New parent for the entry. - * delete [I] Delete old RDN? - * serverctrls [I] Array of LDAP server controls. - * clientctrls [I] Array of LDAP client controls. - * - * RETURNS - * Success: LDAP_SUCCESS - * Failure: An LDAP error code. */ ULONG CDECL ldap_rename_ext_sW( LDAP *ld, WCHAR *dn, WCHAR *newrdn, WCHAR *newparent, int delete, LDAPControlW **serverctrls, LDAPControlW **clientctrls ) diff --git a/dlls/wldap32/search.c b/dlls/wldap32/search.c index a673851b148..738344de685 100644 --- a/dlls/wldap32/search.c +++ b/dlls/wldap32/search.c @@ -32,8 +32,6 @@ WINE_DEFAULT_DEBUG_CHANNEL(wldap32); /*********************************************************************** * ldap_searchA (WLDAP32.@) - * - * See ldap_searchW. */ ULONG CDECL ldap_searchA( LDAP *ld, char *base, ULONG scope, char *filter, char **attrs, ULONG attrsonly ) { @@ -59,26 +57,6 @@ exit: /*********************************************************************** * ldap_searchW (WLDAP32.@) - * - * Search a directory tree (asynchronous operation). - * - * PARAMS - * ld [I] Pointer to an LDAP context. - * base [I] Starting point for the search. - * scope [I] Search scope. One of LDAP_SCOPE_BASE, - * LDAP_SCOPE_ONELEVEL and LDAP_SCOPE_SUBTREE. - * filter [I] Search filter. - * attrs [I] Attributes to return. - * attrsonly [I] Return no values, only attributes. - * - * RETURNS - * Success: Message ID of the search operation. - * Failure: ~0u - * - * NOTES - * Call ldap_result with the message ID to get the result of - * the operation. Cancel the operation by calling ldap_abandon - * with the message ID. */ ULONG CDECL ldap_searchW( LDAP *ld, WCHAR *base, ULONG scope, WCHAR *filter, WCHAR **attrs, ULONG attrsonly ) { @@ -92,8 +70,6 @@ ULONG CDECL ldap_searchW( LDAP *ld, WCHAR *base, ULONG scope, WCHAR *filter, WCH /*********************************************************************** * ldap_search_extA (WLDAP32.@) - * - * See ldap_search_extW. */ ULONG CDECL ldap_search_extA( LDAP *ld, char *base, ULONG scope, char *filter, char **attrs, ULONG attrsonly, LDAPControlA **serverctrls, LDAPControlA **clientctrls, ULONG timelimit, ULONG sizelimit, ULONG *message ) @@ -127,31 +103,6 @@ exit: /*********************************************************************** * ldap_search_extW (WLDAP32.@) - * - * Search a directory tree (asynchronous operation). - * - * PARAMS - * ld [I] Pointer to an LDAP context. - * base [I] Starting point for the search. - * scope [I] Search scope. One of LDAP_SCOPE_BASE, - * LDAP_SCOPE_ONELEVEL and LDAP_SCOPE_SUBTREE. - * filter [I] Search filter. - * attrs [I] Attributes to return. - * attrsonly [I] Return no values, only attributes. - * serverctrls [I] Array of LDAP server controls. - * clientctrls [I] Array of LDAP client controls. - * timelimit [I] Timeout in seconds. - * sizelimit [I] Maximum number of entries to return. Zero means unlimited. - * message [O] Message ID of the search operation. - * - * RETURNS - * Success: LDAP_SUCCESS - * Failure: An LDAP error code. - * - * NOTES - * Call ldap_result with the message ID to get the result of - * the operation. Cancel the operation by calling ldap_abandon - * with the message ID. */ ULONG CDECL ldap_search_extW( LDAP *ld, WCHAR *base, ULONG scope, WCHAR *filter, WCHAR **attrs, ULONG attrsonly, LDAPControlW **serverctrls, LDAPControlW **clientctrls, ULONG timelimit, ULONG sizelimit, @@ -192,8 +143,6 @@ exit: /*********************************************************************** * ldap_search_ext_sA (WLDAP32.@) - * - * See ldap_search_ext_sW. */ ULONG CDECL ldap_search_ext_sA( LDAP *ld, char *base, ULONG scope, char *filter, char **attrs, ULONG attrsonly, LDAPControlA **serverctrls, LDAPControlA **clientctrls, struct l_timeval *timeout, @@ -228,29 +177,6 @@ exit: /*********************************************************************** * ldap_search_ext_sW (WLDAP32.@) - * - * Search a directory tree (synchronous operation). - * - * PARAMS - * ld [I] Pointer to an LDAP context. - * base [I] Starting point for the search. - * scope [I] Search scope. One of LDAP_SCOPE_BASE, - * LDAP_SCOPE_ONELEVEL and LDAP_SCOPE_SUBTREE. - * filter [I] Search filter. - * attrs [I] Attributes to return. - * attrsonly [I] Return no values, only attributes. - * serverctrls [I] Array of LDAP server controls. - * clientctrls [I] Array of LDAP client controls. - * timeout [I] Timeout in seconds. - * sizelimit [I] Maximum number of entries to return. Zero means unlimited. - * res [O] Results of the search operation. - * - * RETURNS - * Success: LDAP_SUCCESS - * Failure: An LDAP error code. - * - * NOTES - * Call ldap_msgfree to free the results. */ ULONG CDECL ldap_search_ext_sW( LDAP *ld, WCHAR *base, ULONG scope, WCHAR *filter, WCHAR **attrs, ULONG attrsonly, LDAPControlW **serverctrls, LDAPControlW **clientctrls, struct l_timeval *timeout, @@ -311,8 +237,6 @@ exit: /*********************************************************************** * ldap_search_sA (WLDAP32.@) - * - * See ldap_search_sW. */ ULONG CDECL ldap_search_sA( LDAP *ld, char *base, ULONG scope, char *filter, char **attrs, ULONG attrsonly, LDAPMessage **res ) @@ -340,25 +264,6 @@ exit: /*********************************************************************** * ldap_search_sW (WLDAP32.@) - * - * Search a directory tree (synchronous operation). - * - * PARAMS - * ld [I] Pointer to an LDAP context. - * base [I] Starting point for the search. - * scope [I] Search scope. One of LDAP_SCOPE_BASE, - * LDAP_SCOPE_ONELEVEL and LDAP_SCOPE_SUBTREE. - * filter [I] Search filter. - * attrs [I] Attributes to return. - * attrsonly [I] Return no values, only attributes. - * res [O] Results of the search operation. - * - * RETURNS - * Success: LDAP_SUCCESS - * Failure: An LDAP error code. - * - * NOTES - * Call ldap_msgfree to free the results. */ ULONG CDECL ldap_search_sW( LDAP *ld, WCHAR *base, ULONG scope, WCHAR *filter, WCHAR **attrs, ULONG attrsonly, LDAPMessage **res ) @@ -370,8 +275,6 @@ ULONG CDECL ldap_search_sW( LDAP *ld, WCHAR *base, ULONG scope, WCHAR *filter, W /*********************************************************************** * ldap_search_stA (WLDAP32.@) - * - * See ldap_search_stW. */ ULONG CDECL ldap_search_stA( LDAP *ld, const PCHAR base, ULONG scope, const PCHAR filter, char **attrs, ULONG attrsonly, struct l_timeval *timeout, LDAPMessage **res ) @@ -399,26 +302,6 @@ exit: /*********************************************************************** * ldap_search_stW (WLDAP32.@) - * - * Search a directory tree (synchronous operation). - * - * PARAMS - * ld [I] Pointer to an LDAP context. - * base [I] Starting point for the search. - * scope [I] Search scope. One of LDAP_SCOPE_BASE, - * LDAP_SCOPE_ONELEVEL and LDAP_SCOPE_SUBTREE. - * filter [I] Search filter. - * attrs [I] Attributes to return. - * attrsonly [I] Return no values, only attributes. - * timeout [I] Timeout in seconds. - * res [O] Results of the search operation. - * - * RETURNS - * Success: LDAP_SUCCESS - * Failure: An LDAP error code. - * - * NOTES - * Call ldap_msgfree to free the results. */ ULONG CDECL ldap_search_stW( LDAP *ld, const PWCHAR base, ULONG scope, const PWCHAR filter, WCHAR **attrs, ULONG attrsonly, struct l_timeval *timeout, LDAPMessage **res ) diff --git a/dlls/wldap32/value.c b/dlls/wldap32/value.c index 219f6a6d2f5..a825b57da8d 100644 --- a/dlls/wldap32/value.c +++ b/dlls/wldap32/value.c @@ -32,19 +32,6 @@ WINE_DEFAULT_DEBUG_CHANNEL(wldap32); /*********************************************************************** * ldap_count_values_len (WLDAP32.@) - * - * Count the number of values in an array of berval structures. - * - * PARAMS - * values [I] Pointer to an array of berval structures. - * - * RETURNS - * Success: The number of values counted. - * Failure: 0 - * - * NOTES - * Call ldap_count_values_len with the result of a call to - * ldap_get_values_len. */ ULONG CDECL ldap_count_values_len( struct berval **values ) { @@ -60,8 +47,6 @@ ULONG CDECL ldap_count_values_len( struct berval **values ) /*********************************************************************** * ldap_count_valuesA (WLDAP32.@) - * - * See ldap_count_valuesW. */ ULONG CDECL ldap_count_valuesA( char **values ) { @@ -77,19 +62,6 @@ ULONG CDECL ldap_count_valuesA( char **values ) /*********************************************************************** * ldap_count_valuesW (WLDAP32.@) - * - * Count the number of values in a string array. - * - * PARAMS - * values [I] Pointer to an array of strings. - * - * RETURNS - * Success: The number of values counted. - * Failure: 0 - * - * NOTES - * Call ldap_count_valuesW with the result of a call to - * ldap_get_valuesW. */ ULONG CDECL ldap_count_valuesW( WCHAR **values ) { @@ -105,8 +77,6 @@ ULONG CDECL ldap_count_valuesW( WCHAR **values ) /*********************************************************************** * ldap_get_valuesA (WLDAP32.@) - * - * See ldap_get_valuesW. */ char ** CDECL ldap_get_valuesA( LDAP *ld, LDAPMessage *entry, char *attr ) { @@ -170,22 +140,6 @@ static char **bv2str_array( struct bervalU **bv ) /*********************************************************************** * ldap_get_valuesW (WLDAP32.@) - * - * Retrieve string values for a given attribute. - * - * PARAMS - * ld [I] Pointer to an LDAP context. - * entry [I] Entry to retrieve values from. - * attr [I] Attribute to retrieve values for. - * - * RETURNS - * Success: Pointer to a character array holding the values. - * Failure: NULL - * - * NOTES - * Call ldap_get_valuesW with the result of a call to - * ldap_first_entry or ldap_next_entry. Free the returned - * array with a call to ldap_value_freeW. */ WCHAR ** CDECL ldap_get_valuesW( LDAP *ld, LDAPMessage *entry, WCHAR *attr ) { @@ -214,8 +168,6 @@ WCHAR ** CDECL ldap_get_valuesW( LDAP *ld, LDAPMessage *entry, WCHAR *attr ) /*********************************************************************** * ldap_get_values_lenA (WLDAP32.@) - * - * See ldap_get_values_lenW. */ struct berval ** CDECL ldap_get_values_lenA( LDAP *ld, LDAPMessage *message, char *attr ) { @@ -234,22 +186,6 @@ struct berval ** CDECL ldap_get_values_lenA( LDAP *ld, LDAPMessage *message, cha /*********************************************************************** * ldap_get_values_lenW (WLDAP32.@) - * - * Retrieve binary values for a given attribute. - * - * PARAMS - * ld [I] Pointer to an LDAP context. - * message [I] Entry to retrieve values from. - * attr [I] Attribute to retrieve values for. - * - * RETURNS - * Success: Pointer to a berval array holding the values. - * Failure: NULL - * - * NOTES - * Call ldap_get_values_lenW with the result of a call to - * ldap_first_entry or ldap_next_entry. Free the returned - * array with a call to ldap_value_free_len. */ struct berval ** CDECL ldap_get_values_lenW( LDAP *ld, LDAPMessage *message, WCHAR *attr ) { @@ -276,15 +212,6 @@ struct berval ** CDECL ldap_get_values_lenW( LDAP *ld, LDAPMessage *message, WCH /*********************************************************************** * ldap_value_free_len (WLDAP32.@) - * - * Free an array of berval structures. - * - * PARAMS - * values [I] Array of berval structures. - * - * RETURNS - * Success: LDAP_SUCCESS - * Failure: An LDAP error code. */ ULONG CDECL ldap_value_free_len( struct berval **values ) { @@ -296,8 +223,6 @@ ULONG CDECL ldap_value_free_len( struct berval **values ) /*********************************************************************** * ldap_value_freeA (WLDAP32.@) - * - * See ldap_value_freeW. */ ULONG CDECL ldap_value_freeA( char **values ) { @@ -309,15 +234,6 @@ ULONG CDECL ldap_value_freeA( char **values ) /*********************************************************************** * ldap_value_freeW (WLDAP32.@) - * - * Free an array of string values. - * - * PARAMS - * values [I] Array of string values. - * - * RETURNS - * Success: LDAP_SUCCESS - * Failure: An LDAP error code. */ ULONG CDECL ldap_value_freeW( WCHAR **values ) {