Net::LDAP::Message - Message response from LDAP server


NAME

Net::LDAP::Message - Message response from LDAP server


SYNOPSIS

 use Net::LDAP;


DESCRIPTION

Net::LDAP::Message is a base class for the objects returned by the the Net::LDAP manpage methods abandon, add, bind, compare, delete, modify, moddn, search and unbind.

The sub-class the Net::LDAP::Search manpage returned by search also defines many methods.

If the the Net::LDAP manpage object is in async mode then all these methods, except done and mesg_id, will cause a wait until the request is completed.


METHODS

code ( )
The code value in the result message from the server. Normally for a success zero will be returned. Constants for the result codes can be imported from the the Net::LDAP manpage or the Net::LDAP::Constant manpage module.

control ( )
Return a list of controls that were returned from the server.

control ( OID, ... )
Return a list of controls with the given OIDs that were returned from the server.

dn ( )
The DN in the result message from the server.

done ( )
Returns true if the request has been completed.

error ( )
Returns the error message in the result message from the server. If the server did not include an error message, then the result of ldap_error_desc with the error code from the result message.

error_name ( )
Returns the name of the error code in the result message from the server. See ldap_error_name for a detailed description of the return value.

error_text ( )
Returns the short text description of the error code in the result message from the server. See ldap_error_text for a detailed description of the return value.

error_desc ( )
Returns a long text description of the error code in the result message from the server. See ldap_error_desc for a detailed description of the return value.

is_error ( )
Returns true if the result code is considered to be an error for the operation.

mesg_id ( )
The message id of the request message sent to the server.

referrals ( )
Returns a list of referrals from the result message.

server_error ( )
The error message returned by the server, or undef if the server did not provide a message.

sync ( )
Wait for the server to complete the request.


SEE ALSO

the Net::LDAP manpage, the Net::LDAP::Search manpage, the Net::LDAP::Constant manpage, the Net::LDAP::Util manpage


ACKNOWLEDGEMENTS

This document is based on a document originally written by Russell Fulton <r.fulton@auckland.ac.nz>.


AUTHOR

Graham Barr <gbarr@pobox.com>

Please report any bugs, or post any suggestions, to the perl-ldap mailing list <perl-ldap@perl.org>.


COPYRIGHT

Copyright (c) 1997-2004 Graham Barr. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

 Net::LDAP::Message - Message response from LDAP server