1ldap_delete(3LDAP)          LDAP Library Functions          ldap_delete(3LDAP)
2
3
4

NAME

6       ldap_delete,  ldap_delete_s,  ldap_delete_ext, ldap_delete_ext_s - LDAP
7       delete operation
8

SYNOPSIS

10       cc[ flag... ] file... -lldap[ library... ]
11       #include <lber.h>
12       #include <ldap.h>
13
14       int ldap_delete(LDAP *ld, char *dn);
15
16
17       int ldap_delete_s(LDAP *ld, char *dn);
18
19
20       int ldap_delete_ext(LDAP *ld, char *dn, LDAPControl **serverctrls,
21            LDAPControl **clientctrls, int *msgidp);
22
23
24       int ldap_delete_ext_s(LDAP *ld, char *dn, LDAPControl **serverctrls,
25            LDAPControl **clientctrls);
26
27

DESCRIPTION

29       The ldap_delete_s() function is used to perform an LDAP  delete  opera‐
30       tion synchronously.  It takes dn, the DN of the entry to be deleted. It
31       returns an LDAP error code, indicating the success or  failure  of  the
32       operation.
33
34
35       The  ldap_delete() function is used to perform an LDAP delete operation
36       asynchronously.  It takes the same parameters as  ldap_delete_s(),  but
37       returns  the message id of the request it initiated.  The result of the
38       delete can be obtained by a subsequent call to ldap_result(3LDAP).
39
40
41       The  ldap_delete_ext() function initiates an asynchronous delete opera‐
42       tion  and returns  LDAP_SUCCESS if the request was successfully sent to
43       the server,  or  else  it  returns  a  LDAP  error  code  if  not  (see
44       ldap_error(3LDAP)).  If  successful,  ldap_delete_ext() places the mes‐
45       sage  id  of  the  request  in    *msgidp.   A   subsequent   call   to
46       ldap_result(), can be used to obtain the result of the add request.
47
48
49       The  ldap_delete_ext_s() function initiates a synchronous delete opera‐
50       tion and as such returns the result of the operation itself.
51

ERRORS

53       ldap_delete_s() returns an LDAP error code which can be interpreted  by
54       calling  one of ldap_perror(3LDAP) functions. ldap_delete() returns  −1
55       if something went wrong initiating the request.  It  returns  the  non-
56       negative message id of the request if things were successful.
57

ATTRIBUTES

59       See attributes(5) for a description of the following attributes:
60
61
62
63
64       ┌─────────────────────────────┬─────────────────────────────┐
65       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
66       │Availability                 │SUNWcsl (32-bit)             │
67       │                             │SUNWcslx (64-bit)            │
68       │Interface Stability          │Evolving                     │
69       └─────────────────────────────┴─────────────────────────────┘
70

SEE ALSO

72       ldap(3LDAP), ldap_error(3LDAP), attributes(5)
73
74
75
76SunOS 5.11                        27 Jan 2002               ldap_delete(3LDAP)
Impressum