openldap/doc/man/man3/ldap_abandon.3

70 lines
1.6 KiB
Groff
Raw Normal View History

2002-06-13 11:59:10 +08:00
.TH LDAP_ABANDON 3 "RELEASEDATE" "OpenLDAP LDVERSION"
1999-09-12 12:41:47 +08:00
.\" $OpenLDAP$
2009-01-22 08:40:04 +08:00
.\" Copyright 1998-2009 The OpenLDAP Foundation All Rights Reserved.
1999-09-12 12:41:47 +08:00
.\" Copying restrictions apply. See COPYRIGHT/LICENSE.
1998-08-09 08:43:13 +08:00
.SH NAME
ldap_abandon_ext \- Abandon an LDAP operation in progress
2002-06-21 15:32:54 +08:00
.SH LIBRARY
2009-06-03 08:43:44 +08:00
OpenLDAP LDAP (libldap, \-lldap)
1998-08-09 08:43:13 +08:00
.SH SYNOPSIS
.nf
2006-06-14 08:17:31 +08:00
.B
#include <ldap.h>
.LP
.ft B
int ldap_abandon_ext(
.RS
2006-06-14 08:17:31 +08:00
.ft B
LDAP *\fIld\fB,
Bint \fImsgid\fB,
LDAPControl **\fIsctrls\fB,
LDAPControl **\fIcctrls\fB );
2003-04-29 23:14:35 +08:00
.RE
.fi
1998-08-09 08:43:13 +08:00
.SH DESCRIPTION
The
.B ldap_abandon_ext()
2006-06-14 07:15:06 +08:00
routine is used to send a LDAP Abandon request for an
1998-08-09 08:43:13 +08:00
operation in progress. The \fImsgid\fP passed should be the
2006-06-14 08:19:32 +08:00
message id of an outstanding LDAP operation, such as returned by
.BR ldap_search_ext (3).
1998-08-09 08:43:13 +08:00
.LP
.BR ldap_abandon_ext ()
1998-08-09 08:43:13 +08:00
checks to see if the result of the operation has already come in. If it
has, it deletes it from the queue of pending messages. If not,
2006-06-14 07:09:33 +08:00
it sends an LDAP abandon request to the LDAP server.
1998-08-09 08:43:13 +08:00
.LP
The caller can expect that the result of an abandoned operation
will not be returned from a future call to
.BR ldap_result (3).
.LP
.B ldap_abandon_ext()
allows server and client controls to be passed in via the
.I sctrls
and
.I cctrls
parameters, respectively.
.LP
.B ldap_abandon_ext()
returns a code indicating success or, in the case of failure, the
nature of the failure. See
1998-08-09 08:43:13 +08:00
.BR ldap_error (3)
for details.
.SH DEPRECATED INTERFACES
The
.B ldap_abandon()
routine is deprecated in favor of the
.B ldap_abandon_ext()
routine.
.LP
2006-06-14 07:07:10 +08:00
.so Deprecated
1998-08-09 08:43:13 +08:00
.SH SEE ALSO
.BR ldap (3),
2006-06-14 08:19:32 +08:00
.BR ldap_error (3),
.BR ldap_result (3),
2006-06-14 08:19:32 +08:00
.BR ldap_search_ext (3)
1998-10-25 09:41:42 +08:00
.SH ACKNOWLEDGEMENTS
2006-06-14 07:07:10 +08:00
.so ../Project