Unbind (LDAP function): Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (1 revision)
m (1 revision)
 
(7 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{Template:LDAP:Unbind subtitle}}
{{Template:LDAP:Unbind subtitle}}


This [[Notation conventions for methods#Callable methods|callable]]
This [[Notation conventions for methods#Callable functions|callable]]
function closes a Janus LDAP connection.
function closes a Janus LDAP connection.
It logs off the LDAP user, and it terminates the sending and receiving of
It logs off the LDAP user, and it terminates the sending and receiving of
Line 8: Line 8:
{{Template:LDAP:Unbind syntax}}
{{Template:LDAP:Unbind syntax}}
===Syntax terms===
===Syntax terms===
<table>
<table class="syntaxTable">
<tr><th><i><b>%st</b></i>
<tr><th>%number</th>
</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>
<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 (LDAP property)|ErrorNumber]]</var> and <var>[[ErrorText (LDAP property)|ErrorText]]</var> methods may provide additional details.
The <var>[[ErrorNumber (LDAP function)|ErrorNumber]]</var> and <var>[[ErrorText (LDAP function)|ErrorText]]</var> methods may provide additional details. </td></tr>
</td></tr>
<tr><th>ldap</th>
<tr><th><i><b>%ld</b></i>
<td>An <var>LDAP</var> object variable.
</th><td>An <var>Ldap</var> object variable.
</td></tr></table>
</td></tr></table>
==Usage notes==
==Usage notes==
<ul>
<ul>
<li>After a successful <var>Unbind</var> (and after errors that cause a disconnection),
<li>After a successful <var>Unbind</var> (and after errors that cause a disconnection),
the <var>Ldap</var> method object is ready for another <var>Bind</var>:
the <var>LDAP</var> method object is ready for another <var>Bind</var>:
that is, it is (re)initialized with no associated socket/connection references,
that is, it is (re)initialized with no associated socket/connection references,
in the same state as if <code>%ld = New</code> were issued.
in the same state as if <code>%ld = New</code> were issued.
<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 (&amp;amp;ldquo;implicitly&amp;amp;rdquo;) when the last
get discarded automatically ("implicitly") 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.
</ul>
</ul>
==See also==
==See also==
{{Template:LDAP:Unbind footer}}
{{Template:LDAP:Unbind footer}}

Latest revision as of 21:47, 26 August 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

%number A float variable to contain the status result of the Unbind. Possible results are:
  • 0, which indicates success
  • -1, which indicates a failure due to a lost connection (or a connection was never established)
The ErrorNumber and ErrorText methods may provide additional details.
ldap 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 = New were 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 ("implicitly") when the last reference to it is lost, but it is recommended that you first issue an Unbind call for a more orderly closure.

See also