Share via


ldap_simple_bind_s

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

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

Header winldap.h
Library wldap32.lib
Windows Embedded CE Windows CE .NET 4.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

LDAP_RETCODE
ldap_bind
ldap_bind_s
ldap_simple_bind