Unbind (LDAP function): Difference between revisions
Jump to navigation
Jump to search
m (1 revision) |
m (1 revision) |
||
| Line 12: | Line 12: | ||
</th><td>A float variable to contain the status result of the Unbind. Possible results are: <ul> <li>0, which indicates success <li>-1, which indicates a failure due to a lost connection (or a connection was never established) </ul> | </th><td>A float variable to contain the status result of the Unbind. Possible results are: <ul> <li>0, which indicates success <li>-1, which indicates a failure due to a lost connection (or a connection was never established) </ul> | ||
The <var>[[ErrorNumber ( | The <var>[[ErrorNumber (LDAP property)|ErrorNumber]]</var> and <var>[[ErrorText (LDAP property)|ErrorText]]</var> methods may provide additional details. | ||
</td></tr> | </td></tr> | ||
<tr><th><i><b>%ld</b></i> | <tr><th><i><b>%ld</b></i> | ||
| Line 25: | Line 25: | ||
<li>You can also close a connection (and delete the object) abruptly by issuing | <li>You can also close a connection (and delete the object) abruptly by issuing | ||
a <var>Discard</var> call, and you can achieve the same result by letting an <var>Ldap</var> object | a <var>Discard</var> call, and you can achieve the same result by letting an <var>Ldap</var> object | ||
get discarded automatically (&ldquo;implicitly&rdquo;) when the last | get discarded automatically (&amp;ldquo;implicitly&amp;rdquo;) when the last | ||
reference to it is lost, but it is recommended that you first issue an | reference to it is lost, but it is recommended that you first issue an | ||
<var>Unbind</var> call for a more orderly closure. | <var>Unbind</var> call for a more orderly closure. | ||
Revision as of 22:58, 8 July 2011
Close this LDAP connection (LDAP class)
This callable
function closes a Janus LDAP connection.
It logs off the LDAP user, and it terminates the sending and receiving of
data on the connection and deactivates it.
Syntax
[%number =] ldap:Unbind
Syntax terms
| %st | A float variable to contain the status result of the Unbind. Possible results are:
The ErrorNumber and ErrorText methods may provide additional details. |
|---|---|
| %ld | An Ldap object variable. |
Usage notes
- After a successful Unbind (and after errors that cause a disconnection),
the Ldap method object is ready for another Bind:
that is, it is (re)initialized with no associated socket/connection references,
in the same state as if
%ld = Newwere issued. - You can also close a connection (and delete the object) abruptly by issuing a Discard call, and you can achieve the same result by letting an Ldap object get discarded automatically (&ldquo;implicitly&rdquo;) when the last reference to it is lost, but it is recommended that you first issue an Unbind call for a more orderly closure.