Struct ldap3::result::LdapResult

pub struct LdapResult {
    pub rc: u32,
    pub matched: String,
    pub text: String,
    pub refs: Vec<String>,
    pub ctrls: Vec<Control>,
}

Common components of an LDAP operation result.

This structure faithfully replicates the components dictated by the standard, and is distinctly C-like with its reliance on numeric codes for the indication of outcome. It would be tempting to hide it behind an automatic Result-like interface, but there are scenarios where this would preclude intentional incorporation of error conditions into query design. Instead, the struct implements helper methods, success() and non_error(), which may be used for ergonomic error handling when simple condition checking suffices.

Fields

rc: u32

Result code.

Generally, the value of zero indicates successful completion, but there's a number of other non-error codes arising as a result of various operations. See Section A.1 of RFC 4511.

matched: String

Matched component DN, where applicable.

text: String

Additional diagnostic text.

refs: Vec<String>

Referrals.

Absence of referrals is represented by an empty vector.

ctrls: Vec<Control>

Response controls.

Missing and empty controls are both represented by an empty vector.

Implementations

impl LdapResult

pub fn success(self) -> Result<Self>

If the result code is zero, return the instance itself wrapped in Ok(), otherwise wrap the instance in an LdapError.

pub fn non_error(self) -> Result<Self>

If the result code is 0 or 10 (referral), return the instance itself wrapped in Ok(), otherwise wrap the instance in an LdapError.

Trait Implementations

impl Clone for LdapResult

fn clone(&self) -> LdapResult

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for LdapResult

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for LdapResult

fn fmt(&self, f: &mut Formatter<'_>) -> StdResult<(), Error>

Formats the value using the given formatter.

impl Error for LdapResult

fn source(&self) -> Option<&(dyn Error + 'static)>

The lower-level source of this error, if any.

fn backtrace(&self) -> Option<&Backtrace>

🔬 This is a nightly-only experimental API. (backtrace)

Returns a stack backtrace, if available, of where this error occurred.

fn description(&self) -> &str

👎 Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎 Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

impl From<LdapResult> for LdapError

fn from(source: LdapResult) -> Self

Performs the conversion.