ldap_simple_bind_s (Compact 2013)

3/26/2014

This function authenticates a client to a server using a clear text password.

Syntax

ULONG ldap_simple_bind_s(
  LDAP* ld,
  UNICODE PTCHAR dn,
  UNICODE PTCHAR passwd
);

Parameters

• ld
  [in] Session handle.

• dn
  [in] Distinguished name of the user used to bind. The bind operation uses the dn and passwd parameters to authenticate the user.

• passwd
  [in] Password of the user specified in the dn parameter.

Return Value

If this function succeeds, the return value is LDAP_SUCCESS.

If this function fails, it returns an error code. See the LDAP_RETCODE enumeration for a list of possible return values.

Remarks

This function initiates a simple synchronous bind operation to authenticate a client to an LDAP server. Subsequent bind calls can be used to re-authenticate over the same connection.

Upon completion of the bind operation, this function returns to the caller. Use ldap_simple_bind if you prefer to have the operation carried out asynchronously. Note, however, that if an LDAP 2 server is contacted, no other operations over the connection should be attempted before the bind call has successfully completed.

In a multithreading environment, bind calls are not safe because they apply to the connection as a whole. Use caution if threads share connections, and try to thread binds with other operations.

Requirements

See Also

Reference

LDAP Session Functions
LDAP_RETCODE
ldap_bind
ldap_bind_s
ldap_simple_bind