Unbind (LDAP function)

From m204wiki
Revision as of 20:17, 8 July 2011 by 198.242.244.47 (talk) (Created page with " <span class="pageSubtitle"><section begin=dpl_desc/><section end=dpl_desc/></span> Unbind function <p> <var>Unbind</var> is a member of the <var>[[Ldap...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

<section begin=dpl_desc/><section end=dpl_desc/>

Unbind is a member of the 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

[%st =] %ld:Unbind

Syntax terms

%st 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.

%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 = 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.