Net::LDAP::Message3pm

Usage

 use Net::LDAP;

Overview

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

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

If the Net::LDAP 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 Net::LDAP or Net::LDAP::Constant module.

control ( [ OID, ... ] )

Return the list of controls that were returned from the server. If one or more OIDs are given as arguments, return only the controls of the OIDs given.

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.

Acknowledgements

This document is based on a document originally written by Russell Fulton <[email protected]>.