wine/dlls/wldap32 add.c delete.c

Alexandre Julliard julliard at wine.codeweavers.com
Thu Dec 1 11:15:36 CST 2005


ChangeSet ID:	21604
CVSROOT:	/opt/cvs-commit
Module name:	wine
Changes by:	julliard at winehq.org	2005/12/01 11:15:36

Modified files:
	dlls/wldap32   : add.c delete.c 

Log message:
	Hans Leidekker <hans at it.vu.nl>
	Document the ldap_delete* functions.

Patch: http://cvs.winehq.org/patch.py?id=21604

Old revision  New revision  Changes     Path
 1.5           1.6           +4 -4       wine/dlls/wldap32/add.c
 1.2           1.3           +91 -0      wine/dlls/wldap32/delete.c

Index: wine/dlls/wldap32/add.c
diff -u -p wine/dlls/wldap32/add.c:1.5 wine/dlls/wldap32/add.c:1.6
--- wine/dlls/wldap32/add.c:1.5	1 Dec 2005 17:15:36 -0000
+++ wine/dlls/wldap32/add.c	1 Dec 2005 17:15:36 -0000
@@ -81,7 +81,7 @@ exit:
 /***********************************************************************
  *      ldap_addW     (WLDAP32.@)
  *
- * Add entries to a directory tree (asynchronous operation).
+ * Add an entry to a directory tree (asynchronous operation).
  *
  * Parameters
  *  ld      [I] Pointer to an LDAP context.
@@ -189,7 +189,7 @@ exit:
 /***********************************************************************
  *      ldap_add_extW     (WLDAP32.@)
  *
- * Add entries to a directory tree (asynchronous operation).
+ * Add an entry to a directory tree (asynchronous operation).
  *
  * Parameters
  *  ld          [I] Pointer to an LDAP context.
@@ -309,7 +309,7 @@ exit:
 /***********************************************************************
  *      ldap_add_ext_sW     (WLDAP32.@)
  *
- * Add entries to a directory tree (synchronous operation).
+ * Add an entry to a directory tree (synchronous operation).
  *
  * Parameters
  *  ld          [I] Pointer to an LDAP context.
@@ -414,7 +414,7 @@ exit:
 /***********************************************************************
  *      ldap_add_sW     (WLDAP32.@)
  *
- * Add entries to a directory tree (synchronous operation).
+ * Add an entry to a directory tree (synchronous operation).
  *
  * Parameters
  *  ld      [I] Pointer to an LDAP context.
Index: wine/dlls/wldap32/delete.c
diff -u -p wine/dlls/wldap32/delete.c:1.2 wine/dlls/wldap32/delete.c:1.3
--- wine/dlls/wldap32/delete.c:1.2	1 Dec 2005 17:15:36 -0000
+++ wine/dlls/wldap32/delete.c	1 Dec 2005 17:15:36 -0000
@@ -40,6 +40,11 @@
 
 WINE_DEFAULT_DEBUG_CHANNEL(wldap32);
 
+/***********************************************************************
+ *      ldap_deleteA     (WLDAP32.@)
+ *
+ * See ldap_deleteW.
+ */
 ULONG ldap_deleteA( WLDAP32_LDAP *ld, PCHAR dn )
 {
     ULONG ret = LDAP_NOT_SUPPORTED;
@@ -62,6 +67,24 @@ ULONG ldap_deleteA( WLDAP32_LDAP *ld, PC
     return ret;
 }
 
+/***********************************************************************
+ *      ldap_deleteW     (WLDAP32.@)
+ *
+ * Delete an entry from a directory tree (asynchronous operation).
+ *
+ * Parameters
+ *  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 ldap_deleteW( WLDAP32_LDAP *ld, PWCHAR dn )
 {
     ULONG ret = LDAP_NOT_SUPPORTED;
@@ -91,6 +114,11 @@ ULONG ldap_deleteW( WLDAP32_LDAP *ld, PW
     return ret;
 }
 
+/***********************************************************************
+ *      ldap_delete_extA     (WLDAP32.@)
+ *
+ * See ldap_delete_extW.
+ */
 ULONG ldap_delete_extA( WLDAP32_LDAP *ld, PCHAR dn, PLDAPControlA *serverctrls,
     PLDAPControlA *clientctrls, ULONG *message )
 {
@@ -130,6 +158,27 @@ exit:
     return ret;
 }
 
+/***********************************************************************
+ *      ldap_delete_extW     (WLDAP32.@)
+ *
+ * Delete an entry from a directory tree (asynchronous operation).
+ *
+ * Parameters
+ *  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 ldap_delete_extW( WLDAP32_LDAP *ld, PWCHAR dn, PLDAPControlW *serverctrls,
     PLDAPControlW *clientctrls, ULONG *message )
 {
@@ -171,6 +220,11 @@ exit:
     return ret;
 }
 
+/***********************************************************************
+ *      ldap_delete_ext_sA     (WLDAP32.@)
+ *
+ * See ldap_delete_ext_sW.
+ */
 ULONG ldap_delete_ext_sA( WLDAP32_LDAP *ld, PCHAR dn, PLDAPControlA *serverctrls,
     PLDAPControlA *clientctrls )
 {
@@ -208,6 +262,25 @@ exit:
     return ret;
 }
 
+/***********************************************************************
+ *      ldap_delete_ext_sW     (WLDAP32.@)
+ *
+ * Delete an entry from a directory tree (synchronous operation).
+ *
+ * Parameters
+ *  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 ldap_delete_ext_sW( WLDAP32_LDAP *ld, PWCHAR dn, PLDAPControlW *serverctrls,
     PLDAPControlW *clientctrls )
 {
@@ -245,6 +318,11 @@ exit:
     return ret;
 }
  
+/***********************************************************************
+ *      ldap_delete_sA     (WLDAP32.@)
+ *
+ * See ldap_delete_sW.
+ */
 ULONG ldap_delete_sA( WLDAP32_LDAP *ld, PCHAR dn )
 {
     ULONG ret = LDAP_NOT_SUPPORTED;
@@ -267,6 +345,19 @@ ULONG ldap_delete_sA( WLDAP32_LDAP *ld, 
     return ret;
 }
 
+/***********************************************************************
+ *      ldap_delete_sW     (WLDAP32.@)
+ *
+ * Delete an entry from a directory tree (synchronous operation).
+ *
+ * Parameters
+ *  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 ldap_delete_sW( WLDAP32_LDAP *ld, PWCHAR dn )
 {
     ULONG ret = LDAP_NOT_SUPPORTED;



More information about the wine-cvs mailing list